> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tryprofound.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Chart annotations in AEI

> Mark events on Answer Engine Insights charts to explain changes in your metrics over time

<Info>
  **Available on:** the Enterprise plan

  **Find it in:** Analytics > Answer Engine Insights

  **Required role:** all roles can view, Admin and Editor can create and manage. Prompt update annotations require the View Activity Logs permission.
</Info>

Chart Annotations are notes pinned to a date on a chart. Use them to record events, such as a product launch, a content refresh, or a change to your prompts, so anyone looking at a trend can see the context behind it.

## View annotations

Annotations appear on all time-series line charts in [Answer Engine Insights](/answer-engine-insights/about). AI Marketer (Aim) can also show annotations on the line charts it generates.

1. Find the annotation markers along the bottom of a line chart.
2. Select a marker to see every annotation for that date, newest first. When dates are close together, their markers merge into one.

To hide annotations, open the chart’s settings (the sliders icon) and turn off **Annotations**.

<img src="https://mintcdn.com/profound-37face47/LU_swtbqvG5kIsMS/images/answer-engine-insights/chart-annotations-1.png?fit=max&auto=format&n=LU_swtbqvG5kIsMS&q=85&s=e31d9ae4da273d25be9f857d1621ddba" alt="Line chart with annotation markers along the bottom." width="2016" height="948" data-path="images/answer-engine-insights/chart-annotations-1.png" />

## Types of annotations

### User annotations

Created by people in your organization. Shows anything your team wants to record.

<img src="https://mintcdn.com/profound-37face47/LU_swtbqvG5kIsMS/images/answer-engine-insights/chart-annotations-2.png?fit=max&auto=format&n=LU_swtbqvG5kIsMS&q=85&s=eca27e4e7b867786ddb32f534d4e23a5" alt="User annotation details shown in an annotation panel." width="738" height="562" data-path="images/answer-engine-insights/chart-annotations-2.png" />

### Platform updates

Created automatically by Profound for a model change on an AI platform that it tracks, such as a new ChatGPT model. Platform updates are hidden when that platform isn’t selected in your model filter.

<img src="https://mintcdn.com/profound-37face47/LU_swtbqvG5kIsMS/images/answer-engine-insights/chart-annotations-3.png?fit=max&auto=format&n=LU_swtbqvG5kIsMS&q=85&s=95570e8d767b1cd1559aac27fd021f0a" alt="Platform update annotation details shown in an annotation panel." width="738" height="562" data-path="images/answer-engine-insights/chart-annotations-3.png" />

### Prompt updates

Created automatically by Profound for a daily summary of prompt changes in a category, for example “12 prompts added, 3 disabled.” Prompt updates list the people who made the changes. Select **View activity logs** to see each change in Activity Logs.

<img src="https://mintcdn.com/profound-37face47/LU_swtbqvG5kIsMS/images/answer-engine-insights/chart-annotations-4.png?fit=max&auto=format&n=LU_swtbqvG5kIsMS&q=85&s=2cdd67e16b98dd531a13c5206225bc4e" alt="Prompt update annotation details with a View activity logs option." width="738" height="562" data-path="images/answer-engine-insights/chart-annotations-4.png" />

## Add an annotation

Add an annotation in any of the following ways:

* Select **Add annotation** at the top right of a chart. The date defaults to the end of your selected date range.

  <img src="https://mintcdn.com/profound-37face47/LU_swtbqvG5kIsMS/images/answer-engine-insights/chart-annotations-5.png?fit=max&auto=format&n=LU_swtbqvG5kIsMS&q=85&s=6bd8de2c0ce7f1aebc0748809389ef15" alt="Add annotation button at the top right of a chart." width="1012" height="872" data-path="images/answer-engine-insights/chart-annotations-5.png" />

* Select a single date on a chart to pin it, then select **Annotate** in the tooltip.

  <img src="https://mintcdn.com/profound-37face47/LU_swtbqvG5kIsMS/images/answer-engine-insights/chart-annotations-6.png?fit=max&auto=format&n=LU_swtbqvG5kIsMS&q=85&s=c59f6916996a8bec3cb5dbf5989dc542" alt="Annotate option shown after selecting a date on a chart." width="738" height="562" data-path="images/answer-engine-insights/chart-annotations-6.png" />

* In an open annotation list, select **Add annotation** next to a date.

  <img src="https://mintcdn.com/profound-37face47/LU_swtbqvG5kIsMS/images/answer-engine-insights/chart-annotations-7.png?fit=max&auto=format&n=LU_swtbqvG5kIsMS&q=85&s=351ea08437fbb2d2ae544eb6704ff81e" alt="Add annotation option shown next to a date in an annotation list," width="790" height="324" data-path="images/answer-engine-insights/chart-annotations-7.png" />

Fill in the **Add chart annotation** form:

<img src="https://mintcdn.com/profound-37face47/LU_swtbqvG5kIsMS/images/answer-engine-insights/chart-annotations-8.png?fit=max&auto=format&n=LU_swtbqvG5kIsMS&q=85&s=b42d5eebf310f052a01129a8c1e33eaf" alt="Add chart annotation form with date, description, and category fields." width="760" height="880" data-path="images/answer-engine-insights/chart-annotations-8.png" />

* **Date**: any date within the chart’s selected date range. To annotate a date outside the range, widen the date range first with the top-level filters.

* **Description**: what happened.

* **Categories**: where the annotation shows. By default it’s **All categories**, which applies to your whole organization, including categories you add later. To narrow it, select specific categories. The category you’re viewing is always included.

Select **Save**. Everyone in your organization who can view annotations sees it.

## Edit or delete an annotation

You can edit or delete only the annotations you added.

1. Open the annotation list and select **…** next to your annotation.
2. Select **Edit** to change the annotation, or select **Delete**. Deleting an annotation is permanent.

Platform updates and prompt updates can’t be edited or deleted.

<img src="https://mintcdn.com/profound-37face47/LU_swtbqvG5kIsMS/images/answer-engine-insights/chart-annotations-9.png?fit=max&auto=format&n=LU_swtbqvG5kIsMS&q=85&s=96f3d121ad8d9ca37f46713581618b21" alt="Menu for editing or deleting a user-created annotation." width="618" height="398" data-path="images/answer-engine-insights/chart-annotations-9.png" />

## Investigate an annotation with Aim

If you have access to Aim, select **Investigate with Aim** next to any annotation. Aim opens with the annotation and the chart you were viewing, and starts looking into how the event relates to that metric.

<img src="https://mintcdn.com/profound-37face47/LU_swtbqvG5kIsMS/images/answer-engine-insights/chart-annotations-10.png?fit=max&auto=format&n=LU_swtbqvG5kIsMS&q=85&s=fb0aca6701a25806a353b38b1c1190ca" alt="Investigate with Aim option shown next to an annotation." width="704" height="260" data-path="images/answer-engine-insights/chart-annotations-10.png" />

Aim can also read your annotations when you ask about your Answer Engine Insights data.

## Permissions

<Tip>Learn more in the [Roles and permissions](/platform-config/people/roles-and-permissions) documentation.</Tip>

| Role | View annotations | Add, edit, and delete their own annotations | See prompt updates |
| - | - | - | - |
| Admin | ✅ | ✅ | ✅ |
| Editor | ✅ | ✅ | ❌ |
| Member | ✅ | ❌ | ❌ |
| Viewer - AEI Only | ✅ | ❌ | ❌ |
| Viewer - AEI + AI Marketer | ✅ | ❌ | ❌ |
| Agent Operator | ✅ | ❌ | ❌ |

Prompt updates come from [Activity Logs](/platform-config/activity-logs/about), which are available on the Enterprise plan, and need the **View Activity Logs** permission. Admins on the Enterprise plan can change these defaults with a custom role using the **View chart annotations** and **Create, edit, and delete custom chart annotations** permissions.

Annotations belong to your organization, and category-scoped annotations only show when viewing that category.
