Web Parts
Favourite Documents
Display documents marked as favourites using a SharePoint column filter (Showcase column).
DocumentsFeature Parity: 95%
Get Favourite Documents Working in 3 Steps
15-30 minutes
Prerequisites
- Bonzai 2 package installed on your site
- A document library with a "Showcase" column (or custom column) to mark favourites
1
Add the web part
Edit your page and add "Bonzai Favourite Documents" from the Bonzai category.
2
Select a library and column
Choose the document library, set the Showcase column name and the value to filter by (e.g., "Favorite").
3
Configure display
Set max items, toggle file type and location display, then publish.
When to Use This Web Part
Use this when you need to...
- Display documents marked as favourites in a SharePoint column
- Highlight important or featured documents
- Create a curated document showcase
Best page locations
- Homepage — featured document showcase
- Dashboard pages — important files panel
- Document Center — alongside Document Portal
- Department pages — curated content
Consider alternatives when...
- • Displaying all documents — use Documents Rollup
- • Per-user favourites — this filters by a shared column value
Related web parts:
Documents Rollup — show all documents with filteringDocument Portal — full search with personal favourites
How Favourites Work
This web part filters documents from a SharePoint library based on a column value:
- Create a column in your document library (default name: "Showcase")
- Set the column value to "Favorite" (or your custom value) for documents you want to feature
- The web part displays documents matching that column filter
Shared favourites
Unlike browser-based favourites, documents shown here are determined by the SharePoint column value. All users see the same favourited documents. To personalize, users can set their own column values.
Common Configurations
Copy these ready-to-use configurations:
Featured Documents
Show documents marked as favorites
Best for: Homepage sidebar
Configuration
| title | Featured Documents |
| showcaseColumnName | Showcase |
| showcaseValue | Favorite |
| maxItems | 10 |
| showFileType | On |
Important Policies
Filter by policy category
Best for: Policies page
Configuration
| title | Key Policies |
| showcaseColumnName | Priority |
| showcaseValue | High |
| maxItems | 5 |
| showSiteLocation | Off |
Team Resources
Department curated documents
Best for: Team page
Configuration
| title | Team Resources |
| showcaseColumnName | Team |
| showcaseValue | Marketing |
| usePaging | On |
| itemsPerPage | 5 |
Best Practices
Use a Choice column
Create a Choice column in your library with options like "Favorite", "Featured", "Important" to easily categorize and filter documents.
Configure the column name
The default column name is "Showcase" with value "Favorite". Customize these to match your library's column structure.
Reference
Required Library Setup
Favourite Documents uses a document library and filters items by a Showcase-style column.
- Select an existing document library with files.
- Add a Showcase column (Choice or Text) if it does not exist.
- Set the Showcase value (default: Favorite) on documents you want to feature.
| Column | Type | Required | Description |
|---|---|---|---|
| Title | Single line of text | Yes | Document title (built-in) |
| FileLeafRef | Single line of text | Yes | File name (built-in) |
| FileRef | Hyperlink | Yes | Server-relative path (built-in) |
| Modified | Date/Time | Yes | Used for sorting (built-in) |
| Created | Date/Time | No | Fallback sort |
| Author | Person | No | Displayed when available |
| Showcase | Choice or Text | Yes | Column to filter by (default name). Add choice "Favorite" as an option. |
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: FavoriteStar) |
titleIconUrl | Text | Custom icon URL (overrides icon name) |
description | Text (Multiline) | Optional description below the title |
manageDocsUrl | Text | URL for the "Show More" link |
manageDocsText | Text | Text for the "Show More" link (default: Show More) |
Data Source Settings
| Property | Type | Description |
|---|---|---|
siteUrl | Text | Site URL where the library is located (empty = current site) |
listName | List Picker | Document library to display files from |
showcaseColumnName | Text | Column name to filter by (default: Showcase) |
showcaseValue | Text | Value to look for in the column (default: Favorite) |
Display Settings
| Property | Type | Description |
|---|---|---|
maxItems | Slider (1-50) | Maximum number of documents to display |
showFileType | Toggle | Show file type icon (default: On) |
showSiteLocation | Toggle | Show site location (default: On) |
showAddedDate | Toggle | Show when document was added (default: Off) |
Paging Settings
| Property | Type | Description |
|---|---|---|
usePaging | Toggle | Enable pagination (default: Off) |
itemsPerPage | Slider (3-20) | Items per page when paging is enabled |
Appearance
| Property | Type | Description |
|---|---|---|
chromeType | Dropdown | Chrome type: None, Title Only, Border Only, Title and Border |
fixedHeight | Slider (0-800) | Fixed height in pixels (0 = auto height) |
Features Checklist
- ✅ Filter by SharePoint column value
- ✅ Configurable column name and value
- ✅ File type icons
- ✅ Site location display
- ✅ Added date display
- ✅ Pagination support
- ✅ Custom title with icon and link
- ✅ Show more link
- ✅ Fixed height option