> ## Documentation Index
> Fetch the complete documentation index at: https://mixpanel-edb78807-fix-callout.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Annotations

## Overview

Annotations add valuable context to your reports by linking notes to specific dates. Use them to highlight events such as product launches, marketing campaigns, or data anomalies, so viewers can clearly understand what influenced the metrics.

You can view Annotations directly on time-series charts and in the Annotations side panel across all reports.

## Adding Annotations

<Steps>
  <Step title="Open the Annotations side panel to create an annotation">
    Select the **Annotations** tab (above the query builder) and click the “+” button to add a new annotation.

    <Frame>
      <img src="https://mintcdn.com/mixpanel-edb78807-fix-callout/IROTJ5qfJ8ySRy8M/images/annotations2.png?fit=max&auto=format&n=IROTJ5qfJ8ySRy8M&q=85&s=c803c71c32e323415e9ba6e362b227e6" alt="annotations2" width="1164" height="1232" data-path="images/annotations2.png" />
    </Frame>
  </Step>

  <Step title="Alternatively, you can create annotations from the bottom of a time-series Insights report">
    Charts with time intervals (such as line, stacked line, column, and stacked column charts) are time-series charts and support Annotations.

    Hover over the horizontal axis to locate the time interval, then click the “+” button to create an annotation for that point in time.

    <Frame>
      <img src="https://mintcdn.com/mixpanel-edb78807-fix-callout/IROTJ5qfJ8ySRy8M/images/annotations1.png?fit=max&auto=format&n=IROTJ5qfJ8ySRy8M&q=85&s=f14f0517b1df7802b6baae46c47b2569" alt="annotations1" width="1634" height="980" data-path="images/annotations1.png" />
    </Frame>

    You can also switch over to the [Annotation Timeline](/docs/features/annotations#annotations-timeline) to see all annotations within the date range and create a new annotation.
  </Step>

  <Step title="Select a date and time, then enter a description">
    Add one or more tags to categorize the annotation.

    <Frame>
      <img src="https://mintcdn.com/mixpanel-edb78807-fix-callout/IROTJ5qfJ8ySRy8M/images/annotations3.png?fit=max&auto=format&n=IROTJ5qfJ8ySRy8M&q=85&s=b9eeb0ffbc8c34214f6f10740bddb9d1" alt="annotations3" width="990" height="674" data-path="images/annotations3.png" />
    </Frame>

    <Note>
      Use tags consistently (e.g., Launches, Outages, Holidays, and even Team names) so it is easy to filter and spot patterns.
    </Note>
  </Step>
</Steps>

## Viewing Annotations

Annotations appear as markers directly on the chart. Hover over a marker to view its details.

For example, in the chart below, you can see 1 annotation in March, 4 in May, and 2 in July.

<Frame>
  <img src="https://mintcdn.com/mixpanel-edb78807-fix-callout/IROTJ5qfJ8ySRy8M/images/annotations4.png?fit=max&auto=format&n=IROTJ5qfJ8ySRy8M&q=85&s=8d90db1a1f96853df208aef4acc961bd" alt="annotations4" width="3184" height="1172" data-path="images/annotations4.png" />
</Frame>

### Annotations Side-panel

Open the Annotations side panel (available in all reports) to view all annotations for your report's date range in one place. Select the **Annotations** tab (above the query builder) to open the side-panel.

From the side panel, you can:

* **Browse** all annotations within your report's date range.
* **Hide/Show** annotations
* **Sort** by date
* **Filter** Annotations by tags

<Frame>
  <img src="https://mintcdn.com/mixpanel-edb78807-fix-callout/IROTJ5qfJ8ySRy8M/images/annotations5.png?fit=max&auto=format&n=IROTJ5qfJ8ySRy8M&q=85&s=f4ddbac66672837538e321810be36467" alt="annotations5" width="692" height="896" data-path="images/annotations5.png" />
</Frame>

When you save a report, Mixpanel also saves your current annotation filters. The report will then display only the annotations that match your selected tag filters.

### Annotations Timeline

Open the Annotations Timeline (available in time-series Insights reports) to view all annotations for your report's date range in one place. Once you are on a time-series Insights report (such as a line chart), select the **charts and annotations** view option to open the Annotations Timeline.

From the timeline, you can:

* **View** annotations in a timeline format relative to their position on the time-series chart.
* **Browse** all annotations within your report's date range.
* **Hide/Show** annotations
* **Filter** Annotations by tags

<Frame>
  <img src="https://mintcdn.com/mixpanel-edb78807-fix-callout/IROTJ5qfJ8ySRy8M/images/annotations7.png?fit=max&auto=format&n=IROTJ5qfJ8ySRy8M&q=85&s=26f529c29025163cb1085e8e8a6278da" alt="annotations7" width="2802" height="1746" data-path="images/annotations7.png" />
</Frame>

## Editing and Deleting Annotations

Hover over any existing annotations to see available actions. Clicking the "pencil" button allows you to edit the description and add/remove tags - do note that timestamps can't be edited. Clicking the "trash" button permanently deletes the annotation.

<Frame>
  <img src="https://mintcdn.com/mixpanel-edb78807-fix-callout/IROTJ5qfJ8ySRy8M/images/annotations6.png?fit=max&auto=format&n=IROTJ5qfJ8ySRy8M&q=85&s=b0f8920d8eb6f950b1aaff4d9322d0e9" alt="annotations6" width="682" height="552" data-path="images/annotations6.png" />
</Frame>

<Warning>
  Annotations apply globally across the project. Any edits or deletions affect not only the current report but all reports in the project.
</Warning>

## Collaboration and Visibility

* Users with a project role above consumer can create annotations, and each annotation displays the creator’s name.
* Annotations are visible across all reports in the project.
* Use tags and filters to control which annotations appear at the report level.
