# 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="https://2731380315-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaDMDmegqZUJFhJhF4JQG%2Fuploads%2FNc5jtWgrGJ6AtTfXPPA8%2Fimage.png?alt=media&#x26;token=bb08364f-cc94-4a29-b35f-6abe9bf6268b" 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="https://2731380315-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaDMDmegqZUJFhJhF4JQG%2Fuploads%2FA8OlvlRPlfs1IzG3UDJS%2Fimage.png?alt=media&#x26;token=371fafde-c1b4-4e75-9fde-234c26f7babe" 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="https://2731380315-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaDMDmegqZUJFhJhF4JQG%2Fuploads%2FFMuYmqJEQ33vF7VV0JmM%2Fimage.png?alt=media&#x26;token=19ea8df5-7ba2-4b8f-8497-a0cab7a1b985" 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="https://2731380315-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaDMDmegqZUJFhJhF4JQG%2Fuploads%2FpFwtrrSdhbXLJ4yJQT23%2Fimage.png?alt=media&#x26;token=51d00eb1-909e-4c4e-8c04-18c80db454a2" 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>