Web Parts
Pages Rollup
Display SharePoint pages with sorting, filtering, multiple templates (Default and Card), comments, and likes.
ContentFeature Parity: 95%
Get Pages Rollup Working in 3 Steps
10-20 minutes
Prerequisites
- Bonzai 2 package installed on your site
- Site Pages or a custom list with pages
1
Add the web part
Edit your page and add "Bonzai Pages Rollup" from the Bonzai category.
2
Select source list and view
Choose your pages list from the List picker. Optionally select a view to filter.
3
Configure display
Choose template (Default or Card), set items per page, and configure sort order.
When to Use This Web Part
Use this when you need to...
- Display recent pages on the homepage
- Show pages by category or tag (via views)
- Create a knowledge base listing
- Display child pages of a section
Best page locations
- Homepage — recent pages widget
- Category pages — filtered content
- Documentation hubs — page listings
Consider alternatives when...
- • News specifically — use News Rollup
- • Featured content — use Spotlight Rollup
Related web parts:
News Rollup — news-specific contentSpotlight Rollup — featured/promoted content
Recent Updates
- Image selection prefers higher-resolution page images to avoid low-res thumbnails.
Common Configurations
Copy these ready-to-use configurations:
Recent Pages List
Recent pages in list format
Best for: Homepage sidebar
Configuration
| title | Recent Pages |
| templateName | default |
| sortBy | modified |
| itemsPerPage | 10 |
| showPaging | On |
Page Cards Gallery
Cards with thumbnails
Best for: Department page
Configuration
| title | Pages |
| templateName | card |
| itemsPerRow | 3 |
| itemsPerPage | 6 |
| showComments | On |
Featured Pages
Promoted pages only
Best for: Landing page
Configuration
| showPromotedOnly | On |
| templateName | card |
| itemsPerRow | 4 |
Knowledge Base
Alphabetical page listing
Best for: Documentation hub
Configuration
| title | Knowledge Base |
| sortBy | title |
| templateName | default |
| itemsPerPage | 20 |
Best Practices
Sort by Modified for recent content
Set Sort By to "Modified" to show the most recently updated pages.
Use views for filtering
Create SharePoint views to filter pages by category, then select the view in the web part.
Reference
Site Pages Schema
Pages Rollup reads from a selected list (commonly Site Pages). If no list is selected, it triesPages, SitePages, and Site Pages.
- Select the Site Pages library (or a custom pages list).
- Optional: add a Category column and use views for filtering.
- Optional: use Promoted/Featured values if you enable promoted-only filtering.
- Publish pages so they are visible in the rollup.
| Column | Type | Required | Notes |
|---|---|---|---|
| Title | Single line of text | Yes | Default Site Pages column |
| Banner Image | Image | No | Used for card thumbnails |
| Description | Multiple lines | No | Optional excerpt/summary |
| Category | Choice | No | Optional category filtering via views |
| PromotedState | Number | No | Used when Show Promoted Only is enabled |
Property Pane Configuration
Title Settings
| Property | Type | Description |
|---|---|---|
title | Text | Web part title displayed above the content |
titleUrl | Text | Optional URL to make the title clickable |
titleIconOption | Dropdown | Title icon mode: Custom or None |
titleIconName | Icon Picker | Fluent UI icon picker (default: Page) |
titleIconUrl | Text | Custom icon URL (overrides icon name) |
description | Text (Multiline) | Optional description below the title |
showMoreText | Text | Text for the "Show More" link (default: See all pages) |
showMoreUrl | Text | URL for the "Show More" link (empty = hidden) |
Data Source Settings
| Property | Type | Description |
|---|---|---|
siteUrl | Text | Site URL where the pages library is located (empty = current site) |
listName | List Picker | Source list (e.g., Site Pages) |
viewName | View Picker | View to filter pages (depends on selected list) |
sortBy | Dropdown | Sort by: Modified, Created, or Title |
Display Settings
| Property | Type | Description |
|---|---|---|
templateName | Dropdown | Display template: Default (list) or Card |
itemsPerRow | Dropdown | Items per row (2-4), only for Card template |
itemsPerPage | Slider (1-20) | Number of pages to display per page |
showPaging | Toggle | Show pagination controls (default: On) |
fixedHeight | Slider (0-800) | Fixed height in pixels (0 = auto) |
chromeType | Dropdown | Chrome type: None, Title Only, Border Only, Title and Border |
showPromotedOnly | Toggle | Show only promoted/featured pages |
showComments | Toggle | Show comment count (default: On) |
showLikes | Toggle | Show like count (default: On) |
Features Checklist
- ✅ Default and Card display templates
- ✅ View-based filtering
- ✅ Multiple sort options (Modified, Created, Title)
- ✅ Pagination support
- ✅ Promoted pages filtering
- ✅ Comments and likes display
- ✅ Configurable items per row (Card template)
- ✅ Custom title with icon and link
- ✅ Show more link