> For the complete documentation index, see [llms.txt](https://docs.widgelix.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.widgelix.com/assets/asset-page/dashboard.md).

# Dashboard

The **Dashboard** tab shows the widgets defined in the asset's **asset template**. All assets of the same template share the same dashboard layout, each showing its own data.

<figure><img src="https://2494440469-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fggsr9Xlsze5cwVr4WMof%2Fuploads%2Fx5ZjdkQFd4pOcHpouZsi%2Fasset-dashboard.png?alt=media&amp;token=f5944f26-a0be-41b0-ab77-9cf7e3fab6ad" alt="Asset dashboard"><figcaption><p>Asset dashboard (demo data)</p></figcaption></figure>

## Edit the dashboard

{% hint style="warning" %}
Changes to the dashboard are saved in the asset template and apply to **all assets** of that template.
{% endhint %}

1. Turn on the **Edit** toggle above the widgets. The **+ Add Widget** and **Save** buttons appear and every widget gets a **settings (cogwheel)** button.

<figure><img src="https://2494440469-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fggsr9Xlsze5cwVr4WMof%2Fuploads%2FUTGj6222sg0TMBKB11ht%2Fasset-dashboard-edit.png?alt=media&amp;token=2129e4ba-efff-47d3-a290-c164fa9a5bbc" alt="Dashboard in edit mode"><figcaption><p>Edit mode with the widget toolbar open</p></figcaption></figure>

2. Hover over the cogwheel of a widget to open its toolbar:
   * **Edit**: change the widget configuration.
   * **Copy**: create a copy of the widget that you can reconfigure.
   * **Delete**: remove the widget.
3. Resize a widget with the handle in its bottom right corner.
4. Click **+ Add Widget** to add a new widget.
5. Click **Save** to store the layout. Turn **Edit** off to leave edit mode without further changes.

## Add a widget

The **Select Widget** dialog has two tabs:

<figure><img src="https://2494440469-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fggsr9Xlsze5cwVr4WMof%2Fuploads%2FXKr1dwRAzL3oDN8qlmyt%2Fselect-widget.png?alt=media&amp;token=e75678bc-7498-4505-a62a-f24ce29d7a0f" alt="Select Widget dialog" width="420"><figcaption><p>Select Widget, Basic Widgets</p></figcaption></figure>

* **Basic Widgets**: Gauge, Battery, Chart, Map, Digital, Header, Image, Level, Boolean, Downlink Button, Scatter Plot, Math, Log Chart, Markdown.
* **Advanced Widgets**: Gauge, Digital, Level, Map, Battery, Chart, Scatter Plot, Sankey, Heatmap, Report.

Select a widget type and configure it. Detailed instructions for every widget are in [Widgets](https://docs.widgelix.com/get-started/widgets.md).

{% hint style="info" %}
The dashboard is separate from the [List Widgets](https://docs.widgelix.com/assets/list-widgets.md), which control the compact values shown in the Assets list.
{% endhint %}
