Skip to main content

Create a dashboard

Last updated on

Overview​

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 to generate them from a natural language description.

  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​

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.


Search and pin dashboards​

  • 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​

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​

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​

Each row in the dashboard list displays the following information:

ColumnDescription
NameThe dashboard name and a short description, if one was provided during creation.
TagsLabels assigned to the dashboard for filtering and organization.
OwnerThe user who created or manages the dashboard.
CreatedThe date and time when the dashboard was created.
UpdatedThe date and time when the dashboard was last modified.

Dashboard actions​

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​

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


  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 to configure your first widget.

Edit a dashboard​

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


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 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​

  • 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.

    note

    Save your work frequently. There is no auto-save feature, so unsaved changes are lost if you navigate away without saving.

Next steps​