# Annotations

## What are annotations?

Annotations allow you to add context to your data. Users can annotate chart data points, view annotations in a sidebar, and reply to annotations to have threaded discussions with team members.&#x20;

On line charts, they appear as bubbles on specific data points with a number indicating the number of comments associated with that data point.

## Create an annotation

Add annotations in the following ways:

* If a chart that doesn’t have any annotations in the current view: click the `Add annotation` link in the bottom-left corner of the chart.
* If a chart has annotations visible: click the `View [N] annotations` link in the bottom-left corner of the chart, then click the `+ New annotation` button at the top of the sidebar.

<figure><img src="https://cdn.prod.website-files.com/610c8a14b4df1ae46b1a13a3/6685d3b01fcdcb5a84396b89_annotations_create.gif" alt="Gif of creating a new annotation"><figcaption><p>Create a new annotation</p></figcaption></figure>

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.

For charts that are not grouped by team (anything that’s not a simple line chart with one line representing a team), you will be required to enter a **date range** that the annotation is relevant for. These annotations will not appear on the chart, but just be visible in the sidebar via the `View [N] annotations` link.

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

## View annotations in the sidebar

<figure><img src="https://cdn.prod.website-files.com/610c8a14b4df1ae46b1a13a3/6685d4022e148b308bdc85b9_annotations_view_bubble.gif" alt="Gif of clicking a bubble on a line chart, which opens the annotations sidebar to show the relevant comment."><figcaption><p>Open the annotations sidebar via an annotation bubble</p></figcaption></figure>

Open the Annotations sidebar by clicking `Add annotation` or `View [N] annotation` on any chart.

* The annotations listed in the sidebar are specific to the selected page, and the filters that are set on the page: the date range, and the filtered teams.
* Users can `Reply` to annotations, creating threaded conversations.
* Click the `Apply filters` link next to `Reply` to reset the filters at the top of the page to what the original annotation author had been seeing\*.
* Click the `…` menu next to a comment and select `Copy link` to share a particular comment and the specific filters that were in place when the annotation was made\*.
* Click an annotation in the sidebar to highlight the relevant chart.
* Click an annotation bubble on a chart to highlight the corresponding annotation in the sidebar.

<figure><img src="https://cdn.prod.website-files.com/610c8a14b4df1ae46b1a13a3/6685d4135c99ee59f51384fc_annotations_copylink.gif" alt="Gif of clicking overflow menu on a comment to copy a link"><figcaption><p>Copy a link to a specific comment.</p></figcaption></figure>

\*This is for you to see the same data that the author was seeing, so that any trends or data numbers that they refer to make sense.

## Notifications

[Learn about annotation notifications on our Types of Alerts page.](/knowledge-base/types-of-alerts.md)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.multitudes.com/knowledge-base/annotations.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
