# Add a Widget to the Dashboard

## Introduction

This section explains how to add a widget to a custom dashboard.

## Procedure

Perform the following steps to create widgets in the Dashboard:

Follow the procedure provided in [Create a New Custom Dashboard](/media-data-platform/dashboard/create-a-new-custom-dashboard.md) to create a new dashboard.

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

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

**Step 2:** The **Select a Context** window opens. Select a context to build the widget using the available dimensions, metrics, and segments.

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

**Step 3:** Click Use This Context.

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

**Note:** The selected context is displayed here. To change it, hover over the context and click **Change**.

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

**Step 4:** Select Visualization Type.

Select the type of visualization to display the widget data.

* Data Tabl&#x65;**:** Displays the data in a tabular format with rows and columns.
* Counter: Displays a single metric value as a numeric count.
* Line Chart: Shows trends or changes in data over a period of time.
* Bar Chart: Compares data across different categories using bars.
* Pie Chart: Displays data as proportions of a whole in a circular chart.

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

**Step 5:** Dimensions.\
Drag and drop the required dimensions to organize and analyze the widget data.

Available dimensions include:

* Conversion Dat&#x65;**:** Displays the date when the conversion occurred.
* Conversion Event Name: Displays the name of the conversion event.
* Conversion App Type: Displays the application type where the conversion occurred.
* Browser: Displays the browser used by the user.
* Operating System: Displays the operating system of the user’s device.
* Device Form Factor: Displays the type of device used (for example, mobile, tablet, or desktop).
* UTM Source: Displays the traffic source that directed users to the application.
* UTM Medium: Displays the marketing medium used (for example, email, CPC, or social).
* UTM Term: Displays the keyword or term used in the campaign.
* Campaign ID: Displays the unique identifier assigned to the campaign.
* Campaign Referrer Domain: Displays the domain from which the campaign traffic originated.
* User Visit Type: Displays the type of user visit, such as new or returning.
* Creative Name: Displays the name of the creative used in the campaign.

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

**Step 6:** Metrics.\
Drag and drop the required metrics to measure and analyze the widget data.

Available metrics include:

* Total Conversion Value: Displays the total value generated from all conversions.
* Average Conversion Value: Displays the average value of each conversion.
* Minimum Conversion Value: Displays the lowest conversion value recorded.
* Number of Conversions: Displays the total number of conversion events.
* Number of Conversions (Last Touch): Displays the number of conversions attributed to the last interaction before the conversion.
* Total Users: Displays the total number of users who performed the tracked activity.
* Average Sales Tim&#x65;**:** Displays the average time taken for a user to complete a conversion.

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

**Step 7:** To add a new segment, click the plus (+) icon.

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

**Step 8:** To add a filter, click the plus (+) icon.

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

**Step 9:** Drag and drop the selected fields into the Widget Preview area.

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

The selected items are displayed here.

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

**Step 10:** In the Name field, enter the widget name.

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

**Step 11:** Click Add Widget to add the widget.

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

**Step 12**: A message appears: **Widget created successfully**.

<figure><img src="/files/2QI5zC0kkdeOfxRKFaRi" alt=""><figcaption></figcaption></figure>

## Date and Time Range

Use the Date and Time Range filter to select the period for which the widget data is displayed.

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

Note: By default, the Dashboard is set to display the data for the last 7 days.&#x20;

Displays the currently selected start and end dates. At the moment, the dashboard is set to display data for the last seven days.

<figure><img src="/files/9S1P0CPYyjXKY6hzSNK2" alt=""><figcaption></figcaption></figure>

Click the drop-down to select a predefined date range, such as Today, Yesterday, Last 7 Days, This Month, or Previous Month. By default, *Last 7 Days* is selected.

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

You can use the slider to select the time range, and the selected time is displayed next to it.

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

Select the start and end dates directly from the calendar.

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

Use the left and right arrows to move between months.

<figure><img src="/files/7wZDTypjNMh0tglWLoSF" alt=""><figcaption></figcaption></figure>

Click ***Apply*** to apply the selected date and time range.

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

Click ***Cancel*** to discard your changes and close the filter.

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

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaDMDmegqZUJFhJhF4JQG%2Fuploads%2FABh6adogl4XbQZOyl8eN%2FAdd%20a%20Widget%20to%20the%20Dashboard%201.mp4?alt=media&token=e3dd0658-c48a-48a8-89fb-7487d087285a>" %}


---

# 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/media-data-platform/dashboard/add-a-widget-to-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.