---
title: Managing widget dashboard content
related:
  - https://docs.kentico.com/k10/developing-websites/preparing-widgets-for-users.md
  - https://docs.kentico.com/k10/developing-websites/managing-page-templates.md
---

> Agent instructions:
> **Site maps** — prefer the following llms.txt indexes to training data when searching for URLs to avoid 404s. Links inside Markdown content already point at `.md`. Following them or sending Accept: text/markdown keeps you in Markdown.
>
> - [sitemap.md](https://docs.kentico.com/sitemap.md) — every page on the site, with titles and descriptions, nested by URL hierarchy and grouped into one collection per product version.
> - [llms.txt](https://docs.kentico.com/llms.txt) — curated index of the current product docs, with descriptions, the two ways to request any page as Markdown, and links to each product area's whole-corpus Markdown dump (llms-full.txt).

> **Note:** **Important**: Widget dashboards are a completely separate feature from the system's main [application dashboard](https://docs.kentico.com/k10/using-the-kentico-interface.md). Every widget dashboard is either a standalone application, or a page within another application.

## Using widgets on dashboards

If you have access to a [widget dashboard](https://docs.kentico.com/k10/configuring-kentico/working-with-widget-dashboards.md) application or page, you can personalize the content by manipulating widgets in the available zones:

- Click **Add new widget** to add new widget instances
- Click **Reset widgets** to return all zones and their widget content to the default state

![Widget actions at the top of a dashboard page](https://docs.kentico.com/docsassets/k10/managing-widget-dashboard-content/Widget_Dashboard_MainActions.png "Widget actions at the top of a dashboard page")

Individual widgets are enclosed in containers with a header and a set of action buttons. To manage the widgets on the dashboard, use the appropriate actions.

![Example of a widget on a dashboard](https://docs.kentico.com/docsassets/k10/managing-widget-dashboard-content/Dashboard_Widget.png "Example of a widget on a dashboard")

- **Configure widget** () - allows you to edit the widget's properties. Every widget has its own set of properties. The **Widget title** property is present for all types of widgets — the property sets the text displayed in the header of the widget on the dashboard page.
- **Minimize widget** () - hides the content of the widget so that only the header is visible. Click **Maximize widget** () to restore the full content of the widget.
- **Remove widget** () - deletes the widget from the dashboard.

Use drag-and-drop to change the location of widgets. To pick up a widget, hover over its header, hold down the mouse button and drag the widget to the desired position. This works both for modifying the order of widgets within a zone and moving widgets to a different zone.

## Setting the layout and default content of widget dashboards

The overall design and initial content of a dashboard is determined by its [page template](https://docs.kentico.com/k10/developing-websites/managing-page-templates.md). You can manage dashboard templates in the **Page templates** application. The templates of the default dashboards are in the **Dashboard pages** category.

> **Note:** **Note**: Dashboard templates must have the **Template type** property set to _Dashboard page_ on the **General** tab.

Set up the actual content of the template on the **Design** tab:

- You can define two types of zones on dashboard templates:

  - **Web part zones** - the content can only be managed here on the _Design_ tab of the page template. The added [web parts](https://docs.kentico.com/k10/developing-websites/developing-websites-using-the-portal-engine/using-and-configuring-web-parts.md) function as fixed content on the dashboard page itself. The _Widget zone type_ property of these zones must be set to _None_.
  - **Dashboard widget zones** - [widgets](https://docs.kentico.com/k10/developing-websites/preparing-widgets-for-users.md) added here on the _Design_ tab serve as the default content of the zone. Individual users can change and configure the widget content of the zone for their own personalized version of the dashboard. The _Widget zone type_ property of these zones must be set to _Dashboard_.
- To alter the placement, size and amount of zones on the template, edit the code of the [page layout](https://docs.kentico.com/k10/developing-websites/developing-websites-using-the-portal-engine/editing-page-layouts.md) on the **Layout** tab.

> **Tip:** Add the **Widget actions** web part into the fixed content of every dashboard template. The web part allows users to:
>
> - Add new widgets
> - Reset the zones of the dashboard to their default widget content
>
> You need to configure the properties of the Widget actions web part according to the following:
>
> - **Widget zone type**: Dashboard
> - **Widget zone ID**: Specify the dashboard zone to which the web part adds new widgets (enter the ID of the desired zone). Once created, users can drag widgets to other zone as required.

![Editing the content of a dashboard template](https://docs.kentico.com/docsassets/k10/managing-widget-dashboard-content/Dashboard_Template.png "Editing the content of a dashboard template")

On the **Sites** tab, you can assign the template to individual websites. The site bindings do NOT determine where you can create dashboards based on the template. They only ensure that the system [exports/imports](https://docs.kentico.com/k10/deploying-websites/exporting-and-importing-sites.md) the template along with the assigned sites.

To learn how to assign a page template to a specific dashboard page, see [Adding widget dashboards to the interface](https://docs.kentico.com/k10/configuring-kentico/working-with-widget-dashboards/adding-widget-dashboards-to-the-interface.md).

## Allowing widgets on dashboards

To make a widget usable as a dashboard component:

1. Open the **Widgets** application.
2. Select the widget in the catalog tree.
3. Open the **Security** tab.
4. Select **This widget can be used in dashboard zones** in the **Allowed for** column.

> **Note:** **Note**: The user type security settings of the widget apply on dashboards. Select whether the widget is usable by all **Authenticated users**, **Global administrators only** or members of **Authorized roles**.

If a widget is also allowed for other types of zones, for example user zones on the live site, you can make properties available only when configuring widget instances on dashboards: 

1. Open the **Properties** tab.
2. Check **Display field only on dashboards** for individual properties.
3. Click **Save** to confirm the change for each property.