Skip to main content
Available on: the Enterprise planFind it in: Analytics > Answer Engine Insights, Analytics > ShoppingRequired 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 and on the line charts in Shopping. 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.

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.

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.

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.

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.
  • 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.
  • In an open annotation list, select Add annotation next to a date. Add annotation option shown next to a date in an annotation list,
Fill in the Add chart annotation form: Add chart annotation form with date, description, and category fields.
  • 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.

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

Learn more in the Roles and permissions documentation.
Everyone who can see a category sees its annotations, including prompt updates and who made the changes. Prompt updates come from Activity Logs, 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. Annotations belong to your organization, and category-scoped annotations only show when viewing that category.