Web Parts
Events Rollup
Display events with list and tile layouts, search and filters, metadata toggles, and RSVP support.
CommunicationFeature Parity: 90%
Get Events Rollup Working in 3 Steps
15-30 minutes
Prerequisites
- Bonzai 2 package installed on your site
- Site Pages library with event pages
- Optional for RSVP: EventAttendees list with required columns
1
Add Events Rollup to your page
Edit the page, click +, search for "Events Rollup", and add it.
2
Select your list and template
Open the property pane, select a site and list, then choose List or Tile template.
3
Configure options and publish
Set paging, metadata toggles, and optional search/filters, then publish.
When to Use This Web Part
Use this when you need to...
- Display upcoming company events on the homepage
- Show event listings from Site Pages
- Create paginated event listings
- Highlight featured or promoted events
- Allow users to RSVP to events
Best page locations
- Homepage — upcoming events section
- Events page — comprehensive event listing with pagination
- Department pages — filtered events via SharePoint views
Consider alternatives when...
- • Simple announcements without dates — use Important Messages
- • News articles — use News Rollup
- • Complex registration workflows — use a dedicated registration system
Related web parts:
News Rollup — news articles from Site PagesPages Rollup — any page type displayImportant Messages — announcements without dates
Display Templates
Events Rollup supports two display templates:
ListCompact rows — best for sidebars and narrow sections
TileGrid of tiles with configurable columns (1-6 items per row)
Recent Updates
- Search and filter UI (page type, category, tags, date range).
- Metadata toggles (date, time, author, category, tags, likes).
- New: data source mode (custom list vs Pages library) and optional content type filtering in Pages mode.
- New: tile styling and sizing controls (image, badges, padding, font sizes).
- Icon picker, site picker, and list picker improvements.
- Event URL field is preferred when present, with FileRef fallback.
- Progressive REST fallbacks to avoid 400 errors on schema differences.
Step-by-Step Configuration
1
Create event pages in Site Pages
Events are stored as pages in the Site Pages library. Create pages with event content.
Use a "Category" column with value "Events" to distinguish from news articles.
2
Add the web part to your page
Edit your page, click +, search for "Events Rollup", and add it to a section.
3
Configure Title & Navigation
Set the web part title. Optionally add a title URL, "Show More" text and link.
4
Choose a display template
Select List for compact display or Tile for image grid. For Tile, configure items per row (1-6).
5
Select your site and list
Use Site Selection Mode (picker or manual URL), then choose the list with the List Picker.
6
Configure filters and metadata
Set category/tag filters, toggle Search/Filters, and choose which metadata to show (date, time, author, tags, likes).
7
Enable RSVP (optional)
Create the EventAttendees list with required fields and verify permissions so users can RSVP.
8
Set up pagination (optional)
Enable "Show Paging" and set "Items per Page" (1-50) for paginated listings.
9
Publish and test
Save and publish. Verify events display correctly with your chosen template.
RSVP prerequisites (EventAttendees list)
RSVP relies on a list named
EventAttendees (or Event Attendees) with fields for EventPageItemId, UserId, and IsAttending. The service auto-discovers field names, but the list and write permissions must exist.Common Configurations
Homepage Events Widget
Compact upcoming events for the homepage
Best for: Homepage sidebar
Configuration
| Title | Upcoming Events |
| Template | List |
| Show Paging | No |
| Items per Page | 5 |
| Show Date | Yes |
Full Events Page
Complete events listing with pagination
Best for: Dedicated events page
Configuration
| Title | Company Events |
| Template | Tile |
| Items per Row | 3 |
| Show Paging | Yes |
| Items per Page | 12 |
| Enable Search | On |
| Enable Filters | On |
Featured Events
Highlighted promoted events
Best for: Events landing page hero
Configuration
| Title | Featured Events |
| Template | Tile |
| Items per Row | 2 |
| Show Promoted Items | Yes |
| Items per Page | 4 |
Events with View More
Events listing with link to full page
Best for: Department pages
Configuration
| Title | Upcoming Events |
| Template | List |
| Show More Text | View All Events |
| Show More URL | /sites/intranet/events |
| Items per Page | 5 |
Best Practices
Use categories and tags for filtering
Add Category and Tags fields to your events, then enable Filters so users can narrow results.
Include event images
Events with images display much better in Tile mode. Add banner images to your event pages for visual appeal.
Enable RSVP only when the list is ready
RSVP requires an EventAttendees list and write permissions. Add it before enabling RSVP in production.
Configure items per row for Tile template
When using the Tile template, set "Items per Row" (1-6) to control the grid layout. This option is disabled for the List template.
Reference
Event Pages Schema
Events Rollup can read events from the Pages library (default: Site Pages, with fallbacks Pages, SitePages, Site Pages) or from a custom list (when you select one in the property pane). The service discovers common field names, so you can use these recommended columns:
- Create event pages in the Site Pages library.
- Add a Start Date column (Date/Time) — required.
- Optional: add End Date, Location, Address, Category, Tags, and RSVP fields.
- Publish pages so they are visible to readers.
| Column | Type | Required | Notes |
|---|---|---|---|
| Start Date | Date/Time | Yes | Maps to OwlEventPageStartDate or EventDate |
| End Date | Date/Time | No | Maps to OwlEventPageEndDate or EventEndDate |
| Location | Single line of text | No | Maps to OwlEventPageLocation / Location |
| Address | Multiple lines of text | No | Maps to OwlEventPageAddress / Address |
| Category | Choice | No | Maps to OwlEventPageCategory / Category |
| Tags | Managed Metadata | No | Enterprise Keywords / Tags for filters |
| Requires Attendance | Yes/No | No | Maps to OwlEventPageRequiresAttendance / RSVP |
| Max Attendees | Number | No | Maps to OwlEventPageMaxAttendees / MaximumAttendees |
| Event URL | Hyperlink | No | Preferred link target when present |
| Promoted | Yes/No or Number | No | OwlPromoteItem / PromotedState used for featured events |
EventAttendees List Schema (for RSVP)
RSVP requires a separate list to store attendance records.
- Create a list named EventAttendees (or Event Attendees).
- Add the required columns below.
- Ensure users have Contribute permissions to submit RSVP responses.
| Column | Type | Required | Notes |
|---|---|---|---|
| OwlEventPageItemId | Number | Yes | Event page item ID (variants supported: EventPageItemId, EventId) |
| OwlEventUserId | Number | Yes | Current user ID (variants supported: UserId, AttendeeUserId) |
| OwlEventIsAttending | Yes/No | Yes | RSVP state (variants supported: IsAttending, RSVP) |
Property Pane Configuration
Page 1: Basic Settings
| Property | Type | Group | Description |
|---|---|---|---|
title | Text | Title & Navigation | Web part title (blank hides header row) |
titleIconOption | Dropdown | Title & Navigation | Title icon mode: Custom or None |
titleIconName | Icon Picker | Title & Navigation | Fluent UI icon for the header |
titleIconUrl | Text | Title & Navigation | Custom icon URL (overrides icon name) |
titleUrl | Text | Title & Navigation | Make title a link |
showMoreText | Text | Title & Navigation | "View More" link text |
showMoreUrl | Text | Title & Navigation | "View More" link URL |
templateName | Dropdown | Display Options | List or Tile |
itemsPerRow | Dropdown | Display Options | 1-6 (tile only) |
showPromotedItems | Toggle | Display Options | Sort promoted items first |
showRSVP | Toggle | Display Options | Show RSVP controls (requires EventAttendees list) |
showDate | Toggle | Display Options | Show date |
showTime | Toggle | Display Options | Show time |
showAuthor | Toggle | Display Options | Show author |
showCategory | Toggle | Display Options | Show category label |
showTags | Toggle | Display Options | Show tags |
showLikes | Toggle | Display Options | Show likes count when available |
enableSearch | Toggle | Display Options | Show search box |
enableFilters | Toggle | Display Options | Show filter controls (page type, category, tags, date range) |
dataSourceMode | Dropdown | Data Source | Choose Custom List vs Pages Library |
contentTypeFilter | Text | Data Source | Pages Library only: filter items by content type (default: Event Page) |
siteUrlMode | Dropdown | Data Source | Pick a site or enter a manual URL |
selectedSites | Site Picker | Data Source | Selected site when using Site Picker |
siteUrl | Text | Data Source | Manual site URL when Site Selection Mode = manual |
listId | List Picker | Data Source | Source list |
viewId | View Picker | Data Source | Optional view to filter items (depends on selected list) |
selectedCategories | Multi-select | Data Source | Pre-filter categories (optional) |
selectedTags | Multi-select | Data Source | Pre-filter tags (optional) |
Page 2: Advanced Settings
| Property | Type | Group | Description |
|---|---|---|---|
showPaging | Toggle | Pagination | Enable pagination |
itemsPerPage | Slider (1-50) | Pagination | Items per page |
showImage | Toggle | Tile Styling | Tile template: show/hide event image |
tileImageHeight | Slider | Tile Styling | Tile template: image height |
tileOverlayTitle | Toggle | Tile Styling | Tile template: show title over the image |
showLocation | Toggle | Tile Styling | Tile template: show/hide location row |
showCategoryBadge | Toggle | Tile Styling | Tile template: show category as a badge |
categoryBadgeColor | Text | Tile Styling | Tile template: badge background color (optional) |
dateBadgePosition | Dropdown | Tile Styling | Tile template: date badge position (top-left/top-right) |
showPastEvents | Toggle | Date Range | Include past events (default: off) |
filterDateRangeFrom | Text | Date Range | Default lower bound (YYYY-MM-DD). Used when Filters are enabled and user hasn’t selected a date. |
filterDateRangeTo | Text | Date Range | Default upper bound (YYYY-MM-DD). Used when Filters are enabled and user hasn’t selected a date. |
titleFontSize | Slider | Sizing | Tile template: title font size |
metaFontSize | Slider | Sizing | Tile template: meta font size |
cardPadding | Slider | Sizing | Tile template: content padding |
containerPadding | Slider | Sizing | Outer padding for the web part container |
borderRadius | Slider | Sizing | Rounded corners for the web part container |
fixedHeight | Slider (0-1000) | Layout | Fixed height in px |
enableContentTargeting | Toggle | Advanced | Content targeting by SharePoint group |
description | Text (multiline) | Advanced | Web part description |
helpUrl | Text | Advanced | Help documentation URL |
Data Source
Events Rollup supports reading from either a custom list or the Pages library. If no list is selected, it tries Pages, SitePages, and Site Pages. In Pages Library mode, you can optionally filter by content type (commonly Event Page). Event URLs prefer an explicit URL field when present, with FileRef fallback.
Features Checklist
- ✅ Two display templates (List, Tile)
- ✅ Configurable grid layout (1-6 items per row)
- ✅ Pagination with configurable page size
- ✅ Promoted/featured item sorting
- ✅ Search and filter UI (page type, category, tags, date range)
- ✅ Metadata toggles (date, time, author, category, tags, likes)
- ✅ Like count display (when available from linked page)
- ✅ Event URL resolution from URL fields or page FileRef
- ✅ Tile image extraction from page content
- ✅ "View More" link configuration
- ✅ Site picker and list picker
- ✅ Content targeting (SharePoint groups)
- ✅ Fixed height option
- ✅ Cross-site data source
- ✅ RSVP/attendance (EventAttendees list required)
- ❌ Calendar view (not implemented)
Migration from Classic Bonzai
| Classic Feature | Modern Equivalent | Notes |
|---|---|---|
| RSVP functionality | Available | Requires EventAttendees list + permissions |
| Calendar view | Not available | Use SharePoint calendar |
| Attendance tracking | Available | Stored in EventAttendees list |
| Display templates | List, Tile | 2 templates available |
| View filtering | Not available | Use category/tags filters instead |