# Annotate your charts

When performance data shifts, it's not always obvious why. Annotations let you attach short text notes to specific points on a chart — marking events like campaign launches, product releases, or seasonal promotions directly where they appear in the data. This makes it easier to correlate what happened with what changed, whether you're reviewing data yourself or sharing a Databoard with your team.

## Supported charts and permissions

Annotations require chart types that report with time-based granularity. They are supported on [line](/understanding-the-line-visualization), [bar](/understanding-the-bar-visualization), [combo](/understanding-the-combo-visualization), and [heatmap](/understanding-the-heatmap-visualization) visualizations.

Access follows Databoard permissions. Anyone who can view a Databoard can view its annotations — in the app, on internal or shareable links, and on embedded Databoards. Anyone who can edit a Databoard can add, edit, and delete annotations. These controls are available in the Designer, in view mode, and on internal or shareable links when logged in.

## Add an annotation

1. Open a Databoard that contains a supported visualization.
2. Hover over the x-axis at the point in time where you want to add the annotation. A ![annotation](/assets/annotation.c2d4844c0a56d87314c4f64cbfd11f2c356fb43b7899d008d1dd16aad423c88c.419bb737.svg) icon appears on the axis.
3. Click **+** to open the **Add Annotation** dialog.
4. Set the **date** and **time** for the annotation. The timezone shown below the date field reflects your general data source timezone.
5. Enter a description in the text field. You can include a URL — it becomes a clickable link once the annotation is saved.
6. (Optional) Check **View on specific metric only** to limit visibility to this specific metric. When unchecked, the annotation appears globally on all supported charts across the account at that point in time.
7. Click **Save**.


add-annotation-dialog
## View annotations

Saved annotations appear as numbered markers on the x-axis of the chart. The number indicates how many annotations exist at that point in time. Click a marker to read the annotation content.

annotation-markers-on-bar-chart
## Edit an annotation

1. Click the annotation marker on the chart to open the annotation popup.
2. Click **Edit** in the popup.
3. Update the description or any other fields.
4. Click **Save**.


annotation-popup-with-edit-option
## Delete an annotation

1. Click the annotation marker on the chart to open the annotation popup.
2. Click the **trash** icon to delete the annotation.


Annotations are deleted without a confirmation prompt. Make sure you're deleting the right annotation before confirming, as it cannot be restored.

annotation-popup-with-delete-option
Annotations are saved at the exact date and time you specify. As granularity decreases (for example, from daily to monthly), annotations that fall within the same period are grouped together under a single marker with a higher count.

Yes. When unchecked, the annotation is applied globally and appears on all supported charts across your account at that point in time, regardless of data source or metric. Check the box to restrict it to the one specific metric it was added to.

 

Ask Genie
Get instant answers or help with your data using the in-app AI assistant.

Talk to an expert
For customers: Get help with your setup, strategy, or making the most of Databox.

Book a demo
New to Databox? See how it works and get guidance on getting started.

Send an email
Reach out to support for help with your account, data, or technical issues.