The Widgets block lets you display dynamically generated article lists on your knowledge base home page. Unlike the other body blocks where you manually choose and arrange content, widgets pull live data from your knowledge base - so the lists update automatically without any intervention from your team. This makes the Widgets block the only body block that reflects what readers are actually doing on your site, surfacing popular, recently updated, or highly liked articles in real time.
Available widget types
You can add up to five widget types, each showing a different list of articles:
| Widget | What it displays | How it's measured |
|---|---|---|
| Most Viewed Articles | Articles with the highest number of views | A view is counted each time a reader opens an article |
| Most Liked Articles | Articles with the most likes | A like is counted when a reader clicks the icon at the end of an article |
| Most Read Articles | Articles readers have genuinely engaged with | A read is counted when a reader scrolls past 50% of the article, spends more than one minute on it, or clicks a hyperlink within it |
| Recently Modified Articles | Published articles that have been updated and republished | Tracks the republish date |
| Recently Created Articles | New articles published for the first time | Tracks the first publish date |
When an article is published for the first time, it appears in both Recently Created Articles and Recently Modified Articles. This is because the initial publish action is also treated as the article's first modification event.
When to use the Widgets block
- Surfacing popular content - Most Viewed and Most Read widgets help readers discover the articles other users find most useful, which is especially valuable for large knowledge bases where important articles can get buried.
- Highlighting recent activity - Recently Modified and Recently Created widgets keep readers informed about what's new or updated, useful for product documentation that changes frequently.
- Increasing engagement - Most Liked articles surface community-validated content, giving readers a quick way to find high-quality articles without searching.
Only articles the reader has permission to access will appear in widget lists.
How to add a Widgets block
- Navigate to Settings () > Knowledge base site in the left navigation bar of the Knowledge base portal.
- In the left navigation pane, navigate to Site customization.
- Click the Customize site button.
- From the left dropdown, select Home page. The Body section displays the list of body blocks.
- Click Add section.
- Select Widgets from the available options. The widgets block is added with a Widgets dropdown.
- Click Add element and select from the five available widget types. You can add all five in the same block, or create multiple widget blocks on the page.
- Click each widget element to edit its heading.
- Use the Reorder () icon to rearrange elements. The Hide () icon toggles visibility without deleting.
- Click Save, then Preview to review, and Publish to make changes live.
Knowledge base site view
Here is how the Widgets block appears on the knowledge base site, showing article lists with titles and metadata.
How to delete the Widgets block
- Navigate to Settings () > Knowledge base site > Site customization and click Customize site.
- In the Home dropdown, go to the Widgets section. The Widgets panel appears.
- Click Delete at the bottom. A delete confirmation prompt appears.
- Click Yes to confirm.
- To delete individual widget elements, follow the same process - select the element and click Delete.
- Click Save to apply the changes.
- Click Preview to review, and Publish to make changes live.
Best practices
- Lead with the most useful widget for your audience - for a product knowledge base, Most Viewed or Most Read are typically the most useful starting points for readers who don't know where to begin.
- Use custom headings - the default heading for each widget is the widget type name. Renaming it to something like "Popular this week" or "Recently updated" makes it feel more natural on the page.
- Avoid adding all five widgets at once - five lists stacked on the home page becomes overwhelming. Choose two or three that serve your readers best.
- Pair with the Knowledge base categories block - categories help readers navigate by topic, while widgets surface the most popular or recent content. Together they cover both discovery patterns.
FAQ
How do I hide a widget element without deleting it?
Navigate to {{variable.Settings}} () > {{variable.Knowledge base site}} > Site customization. In the Home dropdown, select the Widgets section. Hover over the desired widget element and click the Hide () icon. Click Save and Publish to apply. The hidden element will no longer be visible on the knowledge base site.
How do I rearrange the widget elements?
Navigate to {{variable.Settings}} () > {{variable.Knowledge base site}} > Site customization. In the Home dropdown, select the Widgets section. Hover over the desired element and click the drag and drop () icon to reorder it. Click Save and Publish to apply.
Why do Recently Created Articles and Recently Modified Articles show the same content?
This is expected behaviour. Recently Created Articles shows articles published for the first time, while Recently Modified Articles shows articles that have been updated and republished. When an article is published for the first time, the initial publish is also treated as its first modification event — so newly published articles temporarily appear in both widgets until older modified articles replace them.