> For the complete documentation index, see [llms.txt](https://docs.pharos.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pharos.ai/configuration-guide/advanced/notification-charts.md).

# Notification Charts

Embed System Auto Chart merge fields in issue-update notifications so recipients see occurrence and user-impact charts directly in the message.

Notification Charts lets you embed special **System Auto Chart** merge fields in a notification's body. When the notification is delivered, those merge fields render as **charts**—occurrence trends and user-impact visuals—so recipients get context at a glance without opening Pharos. They render as **donut** or **bar** charts, the same visualizations shown on the [issue detail view](https://docs.pharos.ai/platform-overview/pharos-platform-architecture/issue-tracker/issue-details/impact-statistics.md).

{% hint style="warning" %}
**Charts render only on Issue Update rules.** That's the only place a chart makes sense, so Issue Create and Log Create rules do **not** render these merge fields as charts.
{% endhint %}

***

## Enable Notification Charts

Navigate to **Pharos App → Pharos Admin → Advanced → Notification Charts** and turn on **Enable Notification Charts**. This single toggle is the only setting.

![Notification Charts Settings — the Enable Notification Charts toggle switched on](https://4264222071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fdl9tmJ56lvwg5XY63QYr%2Fuploads%2Fgit-blob-cdb566eabac1e7d64916e2ae8a722336cc440be6%2Fnotification-charts-enabled.png?alt=media)

***

## Adding a Chart to a Notification

Charts are added through merge fields in the body of an **Issue Update** notification action.

1. Edit (or create) an **Issue Update** notification rule and open its notification action. Place your cursor in the **Body** where the chart should appear.
2. Click **Insert Field** to open the **Insert Merge Field** dialog, then search for or select **System Auto Chart**.

   ![Insert Merge Field dialog with "char" typed in search, surfacing the System Auto Chart group](https://4264222071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fdl9tmJ56lvwg5XY63QYr%2Fuploads%2Fgit-blob-5d155a76b866cc5efa2c877b87f246d34ad55180%2Fnotification-charts-merge-field-search.png?alt=media)
3. Open **System Auto Chart** and choose the chart(s) you want to embed.

   ![System Auto Chart expanded, listing Occurrence Last 30 Days, Occurrence Last 7 Days, User Impact Last 30 Days Details, and User Impact Last 7 Days Details](https://4264222071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fdl9tmJ56lvwg5XY63QYr%2Fuploads%2Fgit-blob-2b1327ad03e8a2c971a3e4717c3b39981bf3686e%2Fnotification-charts-merge-field-list.png?alt=media)
4. Insert the field. The corresponding merge field is added to the body—for example, `{!System_Auto_Chart.OCCURRENCE_LAST_30_DAYS}`—and renders as a chart when the notification is sent.

   ![Notification action body containing System Auto Chart merge fields alongside standard issue fields](https://4264222071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fdl9tmJ56lvwg5XY63QYr%2Fuploads%2Fgit-blob-830d78d04ea469c7bee550321b5513e082e036f6%2Fnotification-charts-notification-body.png?alt=media)

***

## Available Charts

| Chart                                | Merge field                                             |
| ------------------------------------ | ------------------------------------------------------- |
| Occurrence — Last 30 Days            | `{!System_Auto_Chart.OCCURRENCE_LAST_30_DAYS}`          |
| Occurrence — Last 7 Days             | `{!System_Auto_Chart.OCCURRENCE_LAST_7_DAYS}`           |
| User Impact — Last 30 Days (Details) | `{!System_Auto_Chart.USER_IMPACT_LAST_30_DAYS_DETAILS}` |
| User Impact — Last 7 Days (Details)  | `{!System_Auto_Chart.USER_IMPACT_LAST_7_DAYS_DETAILS}`  |

***

## Related

* [Issue Notifications](https://docs.pharos.ai/configuration-guide/notifications/issues.md) — configure the issue-update rules where charts render
* [Notifications](https://docs.pharos.ai/configuration-guide/notifications.md) — notification rule and channel setup
* [Alerting](https://docs.pharos.ai/platform-overview/pharos-platform-architecture/alerting.md) — alerting concepts
