# Add Widgets in the Dashboard

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaDMDmegqZUJFhJhF4JQG%2Fuploads%2F1BYUc8QsDyq30GlCtis9%2FAdd%20Widget%20to%20the%20new%20Dashboard%206%20(1).mp4?alt=media&token=b4d226ff-533c-4375-803c-a3f284b50227>" %}

## Procedure

Perform the following steps to create widgets in the Dashboard:

## Before you begin

Before adding a widget, ensure that a new dashboard is created. Follow the steps in **Create a New Dashboard** to create a dashboard. Once the dashboard is created, the **New Widget** option becomes available.

**Step 1**: Click **Add Widgets**.

<figure><img src="/files/ikytgdB6Y2JwIKFImqNd" alt=""><figcaption></figcaption></figure>

**Step 2:** The following visualization types are available:

* **Line Chart:** Displays data trends over time by connecting individual data points with a line.
* **Tags Fired Counter:** Counts and displays the number of times specific tags have been triggered.
* **Pie Chart:** Represents data proportions as slices of a circular chart, showing relative sizes.

Select the appropriate chart type.

<figure><img src="/files/JgRaRvftAeT61USJEEiE" alt=""><figcaption></figcaption></figure>

**Step 3:** Under the **Select Aggregation Attribute** section, click the **Select Attribute** dropdown.\
The following options will be displayed:

* Browser
* Device Type
* Language
* Tag Fire Status

<figure><img src="/files/zr5NwtbNPAcjUlTwLYyC" alt=""><figcaption></figcaption></figure>

| Aggregation Attribute | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| --------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Browser               | Select this option to display information regarding the Browser types such as **Chrome, Safari, Edge, IE, Firefox, Opera, and Other**.                                                                                                                                                                                                                                                                                                                                                                                                       |
| Device Type           | Select this option to display the device type such as **Desktop Web**, **Mobile Web**, **Tablet**, and **Other**.                                                                                                                                                                                                                                                                                                                                                                                                                            |
| Language              | Select this option to set the preferred language. The available languages are **English**, **Spanish**, and **Other**.                                                                                                                                                                                                                                                                                                                                                                                                                       |
| Tag Fire Status       | <p>Select this option to set to one of the Tag trigger Statuses. </p><p>• Success (200) </p><p>• Success (202) </p><p>• Provider Side Failure (400)</p><p> • Provider Side Failure (404) </p><p>• Provider Side Failure (500) </p><p>• Tag Validation Failure (900) </p><p>• Tag Validation Failure (1000) </p><p>• Error (1001) </p><p>• Privacy Blocked (1002) </p><p>• Skipped (1003) </p><p>• Success with Warnings (1004)</p><p>• Scheduled for retry (1005) </p><p>• Maximum retry attempts reached (1006) </p><p>• Delayed (1007)</p> |

**Step 4:** Click **Add Filter** and select the various criteria to filter information.

**Note:** This step is optional and can be skipped if no filtering is needed.

![add widget](https://ingest-lab.netlify.app/images/dashboardimages/addfilter.png)

| Field Type  | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Tag         | Specifies the tag that needs to be filtered.                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| Page Name   | Specifies the Page Name. Select either **contains** or **is** from the Operator drop-down menu.                                                                                                                                                                                                                                                                                                                                                                                       |
| Provider    | Specifies the Provider that needs to be filtered.                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| Device Type | Select this option to display the device type such as **Desktop Web, Mobile Web, Tablet,** and **Other**.                                                                                                                                                                                                                                                                                                                                                                             |
| Browser     | Select this option to display information regarding the Browser types such as **Chrome, Safari, Edge, IE, Firefox, Opera,** and **Other**.                                                                                                                                                                                                                                                                                                                                            |
| Language    | Select this option to set the preferred language.                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| Domain      | Select the appropriate domain name. Select either **contains** or **is** from the **Operator** drop-down menu.                                                                                                                                                                                                                                                                                                                                                                        |
| Status      | <p>Select this option to set to one of the Tag trigger Statuses.<br>• Success (200)<br>• Success (202)<br>• Provider Side Failure (400)<br>• Provider Side Failure (404)<br>• Provider Side Failure (500)<br>• Tag Validation Failure (900)<br>• Tag Validation Failure (1000)<br>• Error (1001)<br>• Privacy Blocked (1002)<br>• Skipped (1003)<br>• Success with Warnings (1004)<br>• Scheduled for retry (1005)<br>• Maximum retry attempts reached (1006)<br>• Delayed (1007)</p> |

**Step 5:** Click the **Operator** dropdown.

The following options will be available:&#x20;

* Is one of: Select this operator to filter data where the field matches any of the values in the specified list.
* Is not one of: Select this operator to filter data where the field does not match any of the values in the specified list.

**Step 6:** When you select the **Operator** , a tab opens below. Click the arrow in the tab to select the filter for a specific field type.

![add widget](https://ingest-lab.netlify.app/images/dashboardimages/addfilterselect.png)

**Step 7:** Click **Add Filter** to add the filter conditions.

<figure><img src="/files/OLMTQOfH8MYFbJfylhRp" alt=""><figcaption></figcaption></figure>

**Step 8:** Enter the Widget **Name** and **Description** under the **Widget Info** section and click **Save**.

![add widget](https://ingest-lab.netlify.app/images/dashboardimages/widgetinfo.png)

&#x20; **Step Result:** The new widget is added successfully.

![add widget](https://ingest-lab.netlify.app/images/dashboardimages/successwidget.png)

The Dashboard screen displays the required filtered information for a default period of 24 hours. You can also specify a time range to display the information for a specific period and click **Refresh**.

![add widget](https://ingest-lab.netlify.app/images/dashboardimages/timerange.png)

**Note:** You can perform the same steps as explained in this procedure for the **Tags Fired Counter** and **Pie Chart**.

[<br>](https://ingest-lab.netlify.app/tagmanager/dashboard/createanewdashboard/)

<table data-view="cards"><thead><tr><th></th><th data-type="rating" data-max="5"></th></tr></thead><tbody><tr><td>Please rate this document to help us improve the content</td><td>null</td></tr></tbody></table>


---

# 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.ingestlabs.com/tag-manager/dashboard/add-widgets-in-the-dashboard.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.
