> For the complete documentation index, see [llms.txt](https://docs.multitudes.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.multitudes.com/knowledge-base/annotations.md).

# Annotations

Add context and track your progress with annotations.

## What are annotations?

Annotations allow you to add context to your data and to track your progress. We recommend that teams add an annotation:&#x20;

1. Whenever there were changes that likely impacted the data – e.g., a planning week, lots of people out sick, etc.
2. Whenever they have a team discussion around a datapoint. Use the annotation to note down what you discussed and what action you're going to take as a team. Then, in your next team discussion, refer back to track your progress.

Users can annotate chart data points, view annotations on the chart, and reply to annotations to have threaded discussions with team members.&#x20;

On the charts, most annotations appear as a teal box on the axis (usually on the relevant date on the X axis) with a number indicating the number of comments associated with that data point. If it's an annotation for an AI intervention, it will appear as a yellow box on the axis with a number (see more about [AI interventions](https://docs.multitudes.com/metrics-and-definitions/ai-impact-feature/ai-impact#adding-ai-interventions)).

## Create an annotation

Annotations are associated with a specific **chart, date, and team**. They will appear on the relevant data point on the chart, i.e. on the specific series (the team's line, for a line chart), and in the month/week/day data point that the date is included in.

To see if you can add an annotation to a chart, hover over a chart axis:&#x20;

* **For a line chart:** Add annotations from the X axis – look for the date you want to add the annotation to and then hover directly over the X axis. When you do this, a "+" sign appears on the axis and a modal appears above it with a button saying "add annotation". (Example below.) Click the "+" sign to have the modal persist, then click "Add annotation" to add the annotation.&#x20;

<figure><img src="https://3759751588-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1eOL1LoKX0USQQUCSepS%2Fuploads%2FkjNel2kb7ZWblwoc41to%2Fimage.png?alt=media&amp;token=23e6d9ef-9632-4826-a2b1-5882f2dde13c" alt=""><figcaption></figcaption></figure>

* **On bar charts:** Add annotations from the X or Y axis. For vertical bar charts, add annotations from the bottom of the bar, on the X axis – hover there to add an annotation. For horizontal bar charts, add annotations from the Y axis; hover there to see the "+" sign and the "Add annotation" modal (example below). As above, click the "+" sign to have the modal persist and then "Add annotation" to add.&#x20;

<figure><img src="https://3759751588-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1eOL1LoKX0USQQUCSepS%2Fuploads%2FlbtibEGuFj81P2D4M4eu%2Fimage.png?alt=media&amp;token=22441f66-4752-47c7-b9a1-5460da36601a" alt=""><figcaption></figcaption></figure>

Once you've clicked "Add annotation", you'll see a modal like the one below. We pre-fill the date, scope, and team(s) with our best guess based on your current filters and the date you clicked to add the annotation on, but double-check that those are correct. Then add your annotation in the text box. If it's an AI intervention (an AI-related experiment), also choose "Is this an AI intervention?". More about [adding AI interventions](https://docs.multitudes.com/metrics-and-definitions/ai-impact-feature/ai-impact#adding-ai-interventions). Regular annotations appear as teal boxes on the axes; AI interventions appear as yellow boxes on the axes.

<figure><img src="https://3759751588-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1eOL1LoKX0USQQUCSepS%2Fuploads%2FCDCpPJ4HMY6tvmdr7d3J%2Fimage.png?alt=media&amp;token=8455153f-d766-42cd-a840-3d194ba493fd" alt=""><figcaption></figcaption></figure>

## View, editing, and replying to annotations

**To view an annotation**, hover over a numbered box. Regular annotations appear as teal boxes on the axes; AI interventions appear as yellow boxes on the axes.

To have the annotation persist as you move your mouse around, click the box. &#x20;

<figure><img src="https://3759751588-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1eOL1LoKX0USQQUCSepS%2Fuploads%2Fg28l2lyTib2a14xlwIn4%2Fimage.png?alt=media&amp;token=b3cf2954-1ceb-47d4-8454-7b6cc6e4797c" alt=""><figcaption></figcaption></figure>

**To edit or delete an annotation**, click to have the annotation persist, then hover over an annotation you wrote. You'll see a pencil – click that to edit – and a trash can – click there to delete. (Image below.)

{% hint style="warning" %}
You can only edit and delete your own annotation&#x73;**.**
{% endhint %}

<figure><img src="https://3759751588-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1eOL1LoKX0USQQUCSepS%2Fuploads%2FEcGjO4OQhLS4zhp6i2LJ%2Fimage.png?alt=media&amp;token=5c3f847e-8383-4b44-baa9-7a999d8bf7d8" alt=""><figcaption></figcaption></figure>

**To reply to an annotation**, hover over the annotation text and look for the arrow pointing to the left. Click that to reply – you'll write your text, then click "Reply".

<figure><img src="https://3759751588-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1eOL1LoKX0USQQUCSepS%2Fuploads%2FtqCd7ZpTZpeCHB3hOrsy%2Fimage.png?alt=media&amp;token=fb815996-802c-4815-97a4-5e1f3d9e5332" alt=""><figcaption></figcaption></figure>

## Notifications

[Learn about annotation notifications here.](/knowledge-base/types-of-notifications.md)
