Set Up and Configure Zenpo Dynamic Blurbs
Add Zenpo Dynamic Blurbs to a modern SharePoint page, bind a list, and map at least Title. The property pane groups are License, Data, Field mapping, Layout, and Appearance.
Shared list, view, cache, and mapping-reset rules are on How Zenpo Web Parts Use Your SharePoint Data.
Bind a list or create a starter list
- Edit the page and select the web part.
- Open the property pane.
- Under Data, set Data source (list).
- Choose a View. The pane hint is A list view can hide or filter items before they show here.
- Set Sort by to Display order (default), Title, or Category.
- Leave Show only active items on unless you want inactive rows to render. Default is on.
- Set Cache duration if you want a value other than the default 5 minutes (recommended).
Heading is optional.
Changing the list resets bindings and remaps likely columns. Changing only the view keeps the bindings. Sort by and the Active filter apply at render time. They do not refetch the list.
Optional starter list
If you can create lists on the site, the pane shows Need a starter list? Create one with sample data. The link is hidden when you cannot create lists.
The dialog title is Create a starter list. It creates one list in this site named Blurbs, with columns Title, Content, Link, Image, Icon, Category, DisplayOrder, ReadMoreLabel, and IsActive. It seeds 12 sample blurbs (11 active and 1 inactive). The samples include photo cards, curated icons, an emoji icon, a card with no link and no read-more, a text-only card, a long-copy card, and one inactive row.
Buttons are Create and Cancel. While it runs, the busy label is Creating the list...
- Success: "{list}" was created with {N} sample blurbs and is now the data source. Replace the samples with your own content in the list.
- Failure: The list could not be created. You may not have permission to create lists in this site.
After creation, the web part binds the new list and its default view and maps all nine roles. Shared starter-list rules are on Create Starter Lists with Sample Data.
Map the nine roles
Under Field mapping, Title is the only required role. Map the others to whichever columns your list already has.
| Role | Notes |
|---|---|
| Title | Required |
| Content | Optional body text |
| Link | Saved exactly as you typed it |
| Image | If an item has both a picture and an icon, the picture is used. |
| Icon | Icon names and emoji both work. If a name is not known, a simple mark shows instead of an empty box. |
| Category | Optional tag |
| Display order | Used when Sort by is Display order |
| Read more label | Optional link label |
| Active | Yes/No column. Items marked No are hidden while Show only active items is on. Only an explicit No, false, or 0 hides a row. |
Unbound optional roles render nothing.
To hide a card without deleting the row, map Active and leave Show only active items on. Changing the toggle re-renders immediately without reloading the list.
Set layout and links
Under Layout:
- Columns: 2, 3 (default), or 4. Narrow pages drop to two, and phones show one.
- Visual placement: Top (default) or Left
- Visual alignment: Left (default), Center, or Right. Disabled when Visual placement is not Top.
- Content alignment
- Content display: Full content (default), 3 lines, 5 lines, or 7 lines
- Icon size: 24–64, default 40
- Circle background behind icons: default on
- Link presentation: No link presentation, Entire card linked, Icon or image linked, or Read More link (default)
- Open links in: Same tab (default) or New tab
Set appearance
Dynamic Blurbs labels the vibe control Theme, not Color vibe.
Under Appearance:
- Theme (same vibe options as other parts)
- Accent color (six colors)
- Border (default on)
- Corner radius (default 4)
- Shadow: None, Subtle (default), or Medium
- Card spacing: 8–24, default 16
Shared theme and accent options are on Appearance Settings: Color Vibe, Accent Color, and Corner Radius.
Empty and retry states
The empty state is editor-only. Editors see No active items in this list / Check the view, the Active field mapping, or add items to the list. Readers see nothing.
If loading fails, the retry button is Try again. Timeout copy is Loading took too long. Check the view and try again.
The source cap is 500 items: This source has more than 500 items. Use a filtered view so the web part can show a bounded set. An editor-only notice appears above 48 rows.