News Rollup

Display Templates

News Rollup supports four display templates:

Recent Updates

• New: Date Field control lets authors choose which DateTime column drives the displayed date. The dropdown is now dynamically populated from the source list's DateTime columns (in addition to the well-known FirstPublishedDate / Created / Modified options, plus Auto).
• New Row display template alongside List, Tile, and Card.
• New Category multi-select pre-filter in the property pane (alongside Tags).
• Full date format controls: text vs numeric, month long/short, year on/off, DMY/MDY/YMD order, separator, 4/2 digit year, with live preview.
• Appearance controls for container padding, border radius, fixed height, image fit, and image source (Banner Image vs Page Thumbnail).
• Card click behavior (content-only vs entire-card) and Open in new window toggle.
• Search box with an optional search button; page-type, category, tag, and date-range filter UI.
• Pagination toggle with explicit items-per-page and a total-items cap (Max News to Show).
• Metadata toggles for date, author, category, tags, views, URL, thumbnail, excerpt, likes, and comments.
• Site picker or manual URL, list picker, showcase dropdown (populated from list Choices), and title icon picker.
• Content Targeting using the TargetAudience column and the viewer's SharePoint groups.

Common Configurations

Copy these ready-to-use configurations for common scenarios:

Best Practices

Reference

Technical details for developers and advanced users.

Site Pages Schema

News Rollup reads from the Site Pages library and tries list name variations (Site Pages, SitePages, Pages). Only Showcase is strictly required when showcaseValue is set to a non-empty value; everything else is optional and is auto-discovered at runtime.

1. Create or use the Site Pages library on the source site.
2. Add a Showcase column (Choice or Single line of text) and set its value to News Rollup on pages you want to surface. Alternative column names Featured and PromotedState are also recognised.
3. Optional: add Category (Choice) for Categories pre-filter and the user-facing Category filter.
4. Optional: add Tags or use Enterprise Keywords / TaxCatchAll for tag filters.
5. Optional: add TargetAudience (Single Line of Text with a SharePoint group name) if you plan to use Content Targeting.
6. Create and publish news pages with a banner image.

Property Pane Configuration

Properties are grouped into accordion sections in the property pane: Header, Data Source, Template & Layout, Pagination, Appearance, Content Visibility, Search & Filters, and Advanced.

Header

Data Source

Template & Layout

Pagination

Appearance

Content Visibility

Search & Filters

Advanced

Data Source

News Rollup reads from the Site Pages library. Queries go to the SharePoint Search API first, then fall back to REST list queries which walk multiple list name variations: SitePages, Site Pages, Pages. Field names are auto-discovered from the list schema (Showcase / Featured / PromotedState, Category, Tags / Enterprise Keywords / TaxCatchAll, _LikeCount, _CommentCount, BannerImageUrl, TargetAudience). Only published pages are returned. Articles are rendered from SharePoint pages with:

• Title: Article headline (always shown).
• Banner Image: Image source depends on the imageSource property. When BannerImage, the web part reads BannerImageUrl and the overrideImageUrl from the Bonzai Page Banner webpart in CanvasContent1, then falls back to getpreview.ashx. When Thumbnail, it reads BannerThumbnailUrl from the Pages API.
• Showcase / Featured: Set to the value picked in showcaseValue (default "News Rollup") for items to appear. Pick "(None - show all pages)" to disable curation.
• Category (optional): Choice column used for the Categories multi-select pre-filter and the user-facing Category filter.
• Tags (optional): Tags, Enterprise Keywords, or TaxCatchAll column used for the Tags pre-filter and the user-facing Tags filter.
• TargetAudience (optional): Single Line of Text column used by Content Targeting to match the viewer's SharePoint groups.
• Author: Page author (shown with "Published by").
• FirstPublishedDate / Created / Modified: Date shown in the metadata row.
• PromotedState: Used to infer page type (News vs Page) for the Page Type filter.
• _LikeCount / _CommentCount / ViewsLifeTime: Optional counts surfaced in the metadata row.

Features Checklist

• ✅ Four display templates (List, Tile, Card, Row)
• ✅ Showcase-based curation + Categories and Tags multi-select pre-filters
• ✅ Search box (with optional search button) and end-user filter bar (page type, category, tags, date range)
• ✅ Pagination with Max News to Show cap and Items per Page
• ✅ Full date formatting (text/numeric, month long/short, year, order, separator, digits) with live preview
• ✅ Metadata toggles (date, author, category, tags, views, URL, thumbnail, excerpt, likes, comments)
• ✅ Tile and card layout controls (scale, max columns, featured-first)
• ✅ Appearance controls (fixed height, container padding, border radius, image fit, image source)
• ✅ Card click behavior + Open in new window
• ✅ Cross-site news aggregation (Site Picker or manual URL, list picker)
• ✅ Content Targeting via TargetAudience column + viewer's SharePoint groups
• ✅ Search API first, REST fallback with field auto-discovery and cross-site list-name resolution
• ✅ Responsive grid with automatic column fitting
• ✅ Theme Manager integration
• ✅ Publish-safe: drafts and folders are excluded on both Search and REST paths

Migration from Classic Bonzai