> For the complete documentation index, see [llms.txt](https://docs.phocassoftware.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.phocassoftware.com/analytics/save-and-share-your-work/add-your-analysis-to-a-dashboard.md).

# Add your analysis to a dashboard

Add the grid from your Analytics analysis to a new or existing dashboard.

You can add your current analysis to a dashboard as a grid widget, so you can view it alongside other charts and information.

### Add a grid to a dashboard

1. In Analytics, prepare the analysis you want to display, including the dimensions, filters, measures, and period.
2. Right-click a cell in the grid and select **Add to dashboard**.

<figure><img src="https://2122657374-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaDGOWDU4SqRSiSPGXHgW%2Fuploads%2Fi8TVqirVKYMH0tKIviat%2Fanalytics-add-dashboard-1.png?alt=media" alt="Analytics grid with Add to dashboard in the right-click menu"><figcaption><p>Add your analysis directly from the grid</p></figcaption></figure>

3. Choose where to add the grid:
   * **Existing dashboard**: Select the dashboard.
   * **New dashboard**: Enter a name for the dashboard.
4. Click **Add** to add the grid and continue working in Analytics, or **Add and open** to add the grid and open the dashboard.

<figure><img src="https://2122657374-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaDGOWDU4SqRSiSPGXHgW%2Fuploads%2FfCHhmjONk8ChFBqlV28d%2Fanalytics-add-dashboard-2.png?alt=media" alt="Add to dashboard window with New dashboard selected and the Add and Add and open buttons"><figcaption><p>Add the grid to a new or existing dashboard</p></figcaption></figure>

The analysis is added as a grid widget in the **ADDED WIDGETS** section.

<figure><img src="https://2122657374-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaDGOWDU4SqRSiSPGXHgW%2Fuploads%2FcxiqivO1OZJuOZqqzYWY%2Fanalytics-add-dashboard-3.png?alt=media" alt="Analytics grid displayed as a widget in the ADDED WIDGETS section of a dashboard"><figcaption><p>The analysis displayed as a grid widget on the dashboard</p></figcaption></figure>

To change the widget name, position, size, or data, see [Edit a dashboard](https://docs.phocassoftware.com/basics/dashboards/edit-a-dashboard.md).

### Add a chart to a dashboard

To display your analysis as a chart, open **Chart builder**, choose the chart type and settings, then click **Add to dashboard**. See [See your data in a chart](https://docs.phocassoftware.com/analytics/explore-your-data/see-your-data-in-a-chart.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.phocassoftware.com/analytics/save-and-share-your-work/add-your-analysis-to-a-dashboard.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
