--- title: "Widgets block" slug: "widgets" description: "The Widgets are the embedded blocks on the platform that serve a specific purpose. Currently, we offer widgets to display five different components." updated: 2026-11-04T11:17:05Z published: 2026-11-04T11:17:05Z canonical: "docs.document360.com/widgets" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.document360.com/llms.txt > Use this file to discover all available pages before exploring further. # Widgets block 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 once per browser session when the article loads. For details, see [Article analytics metrics](/help/docs/article-analytics-metrics). | | **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, clicks, and spends at least 10 seconds of active time on the article. | | **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. | NOTE 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. NOTE Only articles the reader has permission to access will appear in widget lists. --- ## Add a Widgets block 1. Navigate to **Settings** () > **Knowledge base site** in the left navigation bar of the Knowledge base portal. 2. In the left navigation pane, navigate to **Site customization**. 3. Click the **Customize site** button. ![Site customization page showing the Customize site button](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/Site%20customization%20-%201st%20page.png) 1. From the left dropdown, select **Home page**. The Body section displays the list of body blocks. 2. Click **Add section**. 3. Select **Widgets** from the available options. The widgets block is added with a **Widgets** dropdown. 4. 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. 5. Click each widget element to edit its heading. 6. Use the **Reorder** () icon to rearrange elements. The **Hide** () icon toggles visibility without deleting. ![Home page builder showing a Widgets block with all five widget elements added and headings editable](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/Widgets%20block.png) 1. 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. ![Knowledge base site showing the Widgets block with article lists displayed in a card layout](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/1_Screenshot-Widget_knolwedge%20base%20site%202.0%20view.png) --- ## Delete the Widgets block 1. Navigate to **Settings** () > **Knowledge base site** > **Site customization** and click **Customize site**. 2. In the **Home** dropdown, go to the **Widgets** section. The Widgets panel appears. 3. Click **Delete** at the bottom. A delete confirmation prompt appears. 4. Click **Yes** to confirm. 5. To delete individual widget elements, follow the same process - select the element and click **Delete**. 6. Click **Save** to apply the changes. 7. 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 behavior. **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.