> For the complete documentation index, see [llms.txt](https://developer.harness.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.harness.io/harness-platform/3.0/harness-platform-resources/harness-dashboards/dashboard-standard/create-dashboard.md).

# Create a dashboard

### Overview <a href="#overview" id="overview"></a>

Harness Dashboards let you build custom views to track deployments, costs, builds, and other platform data in one place. You can create dashboards manually or use the [AI chat assistant](/harness-ai/use-harness-platform/harness-dashboards/dashboard-standard/ai-assisted-dashboard.md) to generate them from a natural language description.

### Navigate to Dashboards <a href="#navigate-to-dashboards" id="navigate-to-dashboards"></a>

1. In the left sidebar, click the module selector (grid icon) next to the Harness logo.
2. Select **Dashboards**.

The Dashboard page shows two sections:

**1. AI chat window:** An AI chat panel on the left side of the page. You can type a plain-language request such as "Create a dashboard showing deployment failure rates for the last 30 days" and the assistant generates a dashboard for you. The panel also offers quick-action buttons like **List pipelines**, **Ask a support question**, and **Analyze Pipeline Errors** to help you get started quickly. **2. All Dashboards:** A searchable, filterable list of every dashboard in the account, including ones you or your team have created. Use the **Search** bar, **Add filter**, or the sort dropdown (for example, **Recently Updated**) to find a specific dashboard.

### All Dashboards <a href="#all-dashboards" id="all-dashboards"></a>

The **All Dashboards** section lists every dashboard available in your account, including dashboards created by you, your team members, and Harness. Each dashboard is displayed as a row in a table.

{% embed url="<https://app.tango.us/app/embed/video/f6969645-6f59-4f3e-a9b6-ae3240c26e45?narrationType=voice1>" %}

\ <br>

#### Search and pin dashboards <a href="#search-and-pin-dashboards" id="search-and-pin-dashboards"></a>

* **Search:** Use the search bar at the top of the list to find dashboards by name or description. The search is not case-sensitive.
* **Pin:** Select the pin icon next to the search bar to show only your pinned dashboards. Select the icon again to return to the full list. Pinning a dashboard does not affect other users.

#### Filter dashboards <a href="#filter-dashboards" id="filter-dashboards"></a>

Select **+ Add filter** to narrow the dashboard list. You can filter by:

* **Tags:** Select one or more tags. Only dashboards that match all selected tags are shown.
* **Owner:** Select an owner to show only their dashboards.

After applying a filter, a **Tags** dropdown and **+ Filter** option appear below the search bar. Select **Reset** to clear all active filters and return to the full list.

#### Sort dashboards <a href="#sort-dashboards" id="sort-dashboards"></a>

Use the sort dropdown on the right side of the search bar to change the order of the list. The following sort options are available:

* **Recently Updated** (default)
* **Recently Created**
* **Name (A-Z)**
* **Name (Z-A)**

#### Dashboard list columns <a href="#dashboard-list-columns" id="dashboard-list-columns"></a>

Each row in the dashboard list displays the following information:

| Column      | Description                                                                      |
| ----------- | -------------------------------------------------------------------------------- |
| **Name**    | The dashboard name and a short description, if one was provided during creation. |
| **Tags**    | Labels assigned to the dashboard for filtering and organization.                 |
| **Owner**   | The user who created or manages the dashboard.                                   |
| **Created** | The date and time when the dashboard was created.                                |
| **Updated** | The date and time when the dashboard was last modified.                          |

#### Dashboard actions <a href="#dashboard-actions" id="dashboard-actions"></a>

Each row has a three-dot menu (**...**) at the end. Select it to access the following actions:

* **Pin:** Pin the dashboard to the top of your list for quick access. To unpin, open the same menu and select **Unpin**.
* **Update Tags:** Add or remove tags on the dashboard to keep it organized.
* **Clone:** Create a copy of the dashboard. This is useful when you want to reuse an existing layout or set of widgets as a starting point.
* **Delete:** Permanently remove the dashboard. This action cannot be undone.

### Create a dashboard <a href="#create-a-dashboard" id="create-a-dashboard"></a>

There are two ways to create a dashboard: manually through the UI, or with the AI chat assistant.

{% tabs %}
{% tab title="Manual" %}
{% embed url="<https://app.tango.us/app/embed/video/dbd9fe8d-d788-462a-82e5-c646a6dbebaf?narrationType=voice1>" %}

\ <br>

1. On the Dashboards landing page, click **+ Create Dashboard** in the top-right corner.
2. In the **Create New Dashboard** panel:
   * Enter a **Name**.
   * (Optional) Add a **Description**.
   * (Optional) Add **Tags** to help organize and filter dashboards.
3. Click **Submit**.

Your new dashboard opens in edit mode with a blank canvas. You are ready to add widgets. Go to [Create widgets](/harness-ai/use-harness-platform/harness-dashboards/dashboard-standard/create-widgets.md) to configure your first widget.
{% endtab %}

{% tab title="AI Chat assistant" %}
The AI chat assistant is available on the left side of the Dashboards landing page. It provides quick actions and lets you describe dashboards in natural language.

{% embed url="<https://app.tango.us/app/embed/video/435c5d21-3a79-4094-99c7-b5bb006c1403?narrationType=voice1>" %}

\ <br>

1. On the Dashboards landing page, locate the **AI chat** panel on the left. You will see the prompt "How can I help today?" along with quick-action buttons such as **List pipelines**, **Ask a support question**, and **Analyze Pipeline Errors**.
2. In the text field at the bottom, describe the dashboard you want. For example: "Show me a dashboard with daily deployment counts and failure rates for the last 30 days."
3. The AI generates a complete dashboard with widgets, queries, and layout.
4. Review the result and make adjustments as needed.

For more details on supported query types, visualization options, and best practices, go to [AI-assisted dashboards](/harness-ai/use-harness-platform/harness-dashboards/dashboard-standard/ai-assisted-dashboard.md).
{% endtab %}
{% endtabs %}

### Edit a dashboard <a href="#edit-a-dashboard" id="edit-a-dashboard"></a>

To modify a dashboard, click the **Edit** button in the header. This switches the dashboard to edit mode.

{% embed url="<https://app.tango.us/app/embed/video/e45e48c2-abce-4958-8172-285bd455f032?narrationType=voice1>" %}

\ <br>

In edit mode, you can:

* **Change the title or subtitle:** Click directly on the title or subtitle text at the top of the dashboard. Type a new name and click outside the text area to apply it.
* **Add a new widget:** Click the **New Widget** button. This opens the widget configuration panel. Go to [Create widgets](/harness-ai/use-harness-platform/harness-dashboards/dashboard-standard/create-widgets.md) to learn how to configure each widget type.
* **Move a widget:** Click and hold a widget, then drag it to a new position on the grid. The widget snaps to the nearest grid position.
* **Resize a widget:** Hover over the bottom-right corner of a widget until you see a resize handle. Click and drag to make the widget larger or smaller.
* **Edit an existing widget:** Click the edit icon (pencil) on any widget to open its configuration panel.
* **Clone a widget:** Click the clone option on a widget to create an exact copy with the same query and display settings.
* **Delete a widget:** Click the delete option on a widget to remove it from the dashboard.

#### Save or discard your changes <a href="#save-or-discard-your-changes" id="save-or-discard-your-changes"></a>

* **Save:** Click the **Save** button to keep all your changes. The dashboard returns to view mode.
* **Cancel:** Click the **Cancel** button to discard all changes. If you have unsaved changes, a confirmation dialog appears.
* **Navigate away:** If you try to leave the page with unsaved changes, a warning dialog appears. You can choose to stay and save, or leave and lose your changes.

  <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>Save your work frequently. There is no auto-save feature, so unsaved changes are lost if you navigate away without saving.</p></div>

### Next steps <a href="#next-steps" id="next-steps"></a>

* [Create widgets](/harness-ai/use-harness-platform/harness-dashboards/dashboard-standard/create-widgets.md) — Add and configure widgets on your dashboard.
* [AI-assisted dashboards](/harness-ai/use-harness-platform/harness-dashboards/dashboard-standard/ai-assisted-dashboard.md) — Generate dashboards from natural language descriptions.