> For the complete documentation index, see [llms.txt](https://guides.tability.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guides.tability.io/docs/become-a-tability-power-user/ai-mode-how-tos/add-kpi-chart-to-dashboard.md).

# Add a KPI chart to a dashboard

Ask AI Mode to add a KPI chart with actuals and targets to an existing Custom Dashboard.

Put a KPI trend beside your goals and initiatives. AI Mode can add a chart to an existing Custom Dashboard using the KPI, reporting period, and display cadence you choose.

**For:** Execs and managers · **Where:** AI Mode inside Tability

## Watch the walkthrough

{% embed url="<https://318707989-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMULqjSmZyGczPy2I6FGH%2Fuploads%2Fgit-blob-856d0610c8cd4fff5aeb60a02602cac91c678a4a%2Ftability-ai-mode-kpi-charts.mp4?alt=media>" %}
Add a monthly ARR chart with actuals and targets to an existing dashboard. 30-second demo, no audio; fictional workspace data.
{% endembed %}

## 1. Identify the KPI and dashboard

Open **AI Mode**. Have the existing KPI and dashboard links ready. KPI widgets require Premium, permission to view the KPI, and permission to edit the dashboard.

```
Add an ARR KPI chart to [dashboard link]. Use [ARR KPI link], show actuals and targets monthly from 1 January 2026 to 31 December 2026, and place it beside the existing goals and initiatives widgets.

Read the dashboard first. Show the selected KPI, date range, cadence, and proposed placement before saving. Preserve all other widgets, filters, and sharing settings. Do not change the KPI's data or shared defaults.
```

Replace ARR and the dates with your own metric and period. If you give a name instead of a link, check that AI Mode selected the right KPI, especially when different teams use the same name.

## 2. Check the range and cadence

The chart has its own date range and day, week, or month display cadence. Ask for fixed dates when you want a particular reporting year, or a rolling period such as “this quarter” for a dashboard that moves with the calendar.

Dashboard-wide people and date filters do not set the KPI widget's range. If you omit chart settings, it starts from the KPI's saved defaults and then keeps its own settings. Changing the widget does not change the underlying KPI's defaults.

Targets appear when the KPI has targets. A targetless KPI does not gain a target line just because it is added to a dashboard. Check the observations too: monthly points represent the latest recorded actual in each month, not an automatic monthly sum.

## 3. Approve and inspect the chart

```
Add the KPI chart exactly as proposed. Give me the dashboard link and confirm the saved KPI, range, and cadence. Leave the rest of the dashboard unchanged.
```

Open the dashboard and check the chart's label, dates, actuals, and targets against the KPI. Use the dashboard editor to adjust its placement or settings. Dashboard sharing does not grant access to a restricted KPI.

For a new dashboard, start with [Build an executive dashboard](https://guides.tability.io/docs/become-a-tability-power-user/ai-mode-how-tos/build-executive-dashboard.md). For several metrics in a target-and-actual table, [create a KPI View scorecard](https://guides.tability.io/docs/become-a-tability-power-user/ai-mode-how-tos/create-kpi-scorecard.md).

**Done when:** the saved dashboard contains the correct KPI chart and the surrounding widgets remain as intended.

Explore the other [AI Mode how-tos](https://guides.tability.io/docs/become-a-tability-power-user/ai-mode-how-tos.md).
