> ## 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 and Shopping charts to explain changes in your metrics over time

> [!NOTE]
>
> **Available on:** the Enterprise plan
>
> **Find it in:** Analytics > Answer Engine Insights, Analytics > Shopping
>
> **Required role:** all roles can view. Admin and Editor can add annotations and edit or delete their own. Opening prompt updates in Activity Logs requires the View Activity Logs permission.

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](https://docs.tryprofound.com/answer-engine-insights/about.md) and on the line charts in [Shopping](https://docs.tryprofound.com/shopping/about.md). 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**.

![Line chart with annotation markers along the bottom.](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)

## Types of annotations

### User annotations

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

![User annotation details shown in an annotation panel.](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)

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

![Platform update annotation details shown in an annotation panel.](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)

### 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. Changes Profound makes on your organization’s behalf, for example during support work, show Profound as the author. With the View Activity Logs permission, select **View activity logs** to see each change in Activity Logs.

![Prompt update annotation details with a View activity logs option.](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)

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

  ![Add annotation button at the top right of a chart.](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)

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

  ![Annotate option shown after selecting a date on a chart.](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)

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

  ![Add annotation option shown next to a date in an annotation list,](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)

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

![Add chart annotation form with date, description, and category fields.](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)

* **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 see the selected categories sees it.

## Edit or delete an annotation

Only the person who added an annotation can edit or delete it, and their role must also allow adding annotations.

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.

![Menu for editing or deleting a user-created annotation.](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)

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

![Investigate with Aim option shown next to an annotation.](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)

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

In Shopping, you can also ask Aim to explain a rise or drop in a metric, such as the Shopping Visibility Score, merchant score, or product visibility score. Select **Investigate** at the top right of a chart, or select a date range on the chart and then select **Investigate with Aim** in the tooltip.

## Permissions

> [!TIP]
>
> Learn more in the [Roles and permissions](https://docs.tryprofound.com/platform-config/people/roles-and-permissions) documentation.

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

Everyone who can see a category sees its annotations, including prompt updates and who made the changes. Prompt updates come from [Activity Logs](https://docs.tryprofound.com/platform-config/activity-logs/about), which are available on the Enterprise plan. Opening Activity Logs needs the **View Activity Logs** permission.

Adding annotations needs the **Configure prompts, topics and personas** permission, which the Admin and Editor roles have. Admins on the Enterprise plan can grant it to a [custom role](https://docs.tryprofound.com/platform-config/people/custom-roles.md).

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