# Add New Widget

The *Dashboard* can be customized by adding various kinds of widgets.

To add a new widget, click on the **Add Widget** button.

<div align="center"><figure><img src="/files/5Vjk5VghIrScOs6Q9F5H" alt=""><figcaption></figcaption></figure></div>

## Import Widget

Widgets that were prepared beforehand can be imported into the dashboard.

<div align="center"><figure><img src="/files/yxV5r4UKPnBMB7kpWUV4" alt=""><figcaption></figcaption></figure></div>

* **Import API Query**: VirtualMetric is an API-based application. Every component has an API. To see the API of a widget, you have to [expand](/dashboard/layout-and-common-functions.md#expand-widget) the widget. Copy the API and paste it to the **Query** field.

<div align="center"><figure><img src="/files/h5Jiu5S4U1BoaaAhi68d" alt=""><figcaption></figcaption></figure></div>

**Example**:

{% code overflow="wrap" %}

```
https://devapi.virtualmetric.com/API/Query/Read?columns=inventory:host:name,counter:host:439,counter:host:172&groupBy=host&output=top&allowDBPaging=yes&orderDir=desc&topRows=10&rowsPerPage=10&title=Top+Memory+Usage&icon=fa+fa-memory&export=html&liveMode=3&legendposition=3&tooltipinteraction=0&access_token=***********************
```

{% endcode %}

* **Import Widget**: An [exported widget](/dashboard/layout-and-common-functions.md#export) can be imported to the dashboard by adding content to the **Request Content** field.

<div align="center"><figure><img src="/files/BXuNqmHnhbsbrz1vQCY8" alt=""><figcaption></figcaption></figure></div>

**Example**:

{% code overflow="wrap" %}

```json
{"IsSystem":false,"ModuleID":0,"LiveMode":1,"ChartType":3,"RecordStatus":1,"SqlQueryStatus":0,"TimeZone":20,"Forecast":-1,"TopRows":0,"DefinitionID":0,"Interval":-1,"RefID":0,"ID":0,"UseExternalAPI":false,"ChartProperties10":null,"ChartProperties09":null,"ChartProperties08":null,"ChartProperties07":null,"ChartProperties06":null,"ChartProperties05":null,"ChartProperties04":1,"ChartProperties03":1,"ChartProperties02":1,"ChartProperties01":1,"SqlQuery":null,"APIToken":null,"APIUser":null,"APIAddress":null,"Unit":"max","Aggregate":"no","OrderDir":"desc","OrderBy":"default","DrillDown":null,"FilterColumn":null,"Filter":null,"GroupBy":"object","ObjectFilter":"genericwebsite-8194","Columns":"inventory:genericwebsite:name,counter:genericwebsite:952","IconName":null,"LanguageKey":"website content","Name":"website content"}
```

{% endcode %}

* **Import Template**: VirtualMetric offers some prepared widgets that can be imported. Select **Source**, **Level**, and **Template**, and then click **Submit**.

<div align="center"><figure><img src="/files/ZB64xSfpOFE8NS5iORkM" alt=""><figcaption></figcaption></figure></div>

## Add Widget

VirtualMetric offers various widgets.

* **Empty widget**: You can create an empty widget. Select a **Type**, an **Icon**, and add a **Title**. After adding the empty widget, you have to [edit](/dashboard/edit-widget.md) the widget.

<div align="center"><figure><img src="/files/qXWfxhfHG2m56P0APwHb" alt=""><figcaption></figcaption></figure></div>

* **Notes**: Add your notes from the widget to the **Notes** field.

<div align="center"><figure><img src="/files/5wSVVmsNvsK95Mc2blhA" alt=""><figcaption></figcaption></figure></div>

* **Clock**: To add a clock widget, you must select a **Mode** (*Analog* or *Digital*) and **Time Zone**.

<div align="center"><figure><img src="/files/JJDbZfWRdBvOMxz8DTiI" alt=""><figcaption></figcaption></figure></div>

* **Calendar**: To add a calendar widget, you must select a **Time Zone**.

<div align="center"><figure><img src="/files/v0Lp0McexqJhmni1QIIZ" alt=""><figcaption></figcaption></figure></div>

* **Markdown**: Add your markdown expression to the **Markdown** field.

<div align="center"><figure><img src="/files/0cZJy4cNLbMRd6vtJzvv" alt=""><figcaption></figcaption></figure></div>

* **Editor**: Edit your expression in the **Editor** field. You can also write your notes in HTML format by clicking the **< >** (View Html) option.

<div align="center"><figure><img src="/files/1gtlhn5345k5WIx9prye" alt=""><figcaption></figcaption></figure></div>

* **Video**: **Youtube** and **Vimeo** videos also can be added to the dashboard. It should be in the embed format.

<div align="center"><figure><img src="/files/1qjQvEadAd5xGY8EZwFg" alt=""><figcaption></figcaption></figure></div>

* **Title**: Add a title.

<div align="center"><figure><img src="/files/h7RaglFhfwa9us1LSvc3" alt=""><figcaption></figcaption></figure></div>

* **URL Address**: Add a URL address.

<div align="center"><figure><img src="/files/D4Ca5TdHRZe8d1vk6uXT" alt=""><figcaption></figcaption></figure></div>

* **Heatmap**: VirtualMetric also offers a heatmap that shows the general health of the servers. You must select and size the icons. You can also filter the server.

<div align="center"><figure><img src="/files/EMPM6X0wqHMMqSfrnVsL" alt=""><figcaption></figcaption></figure></div>

* **Realtime**: A line chart, showing the metrics in realtime, can be added to the dashboard. By default, it will show the process load, but you can change it by [editing](/dashboard/edit-widget.md) the widget.

<div align="center"><figure><img src="/files/pCsBsje8xg6YkJacjMhj" alt=""><figcaption></figcaption></figure></div>

* **Alarms**: VirtualMetric alarms and alerts can be shown on the dashboard. You can change how you display the alarms (table, chart, etc.) and filter.

<div align="center"><figure><img src="/files/Hr2vgvpUnFadgA2P3yI4" alt=""><figcaption></figcaption></figure></div>

* **Analytics**: The log table can be added to the dashboard. You must add the log query to the **SQL Content** field.

<div align="center"><figure><img src="/files/VgJ9RkRJP3zVMrywc2Uc" alt=""><figcaption></figcaption></figure></div>

* **Network Map**: A map of the network can be added to the dashboard. You can change how it is displayed with the fields displayed in the following image.

<div align="center"><figure><img src="/files/QWXlrSrmz0opGdvzhE2u" alt=""><figcaption></figcaption></figure></div>

* **Network Path**: The network path can be shown on the dashboard.

<div align="center"><figure><img src="/files/9gpLVOv8qchZbAt3o8Sx" alt=""><figcaption></figcaption></figure></div>

**Example**:

<div align="center"><figure><img src="/files/X0TFkjrowEq1EDMBJGcn" alt=""><figcaption></figcaption></figure></div>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.virtualmetric.com/dashboard/add-new-widget.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.