Overview: Annotations

Annotations are short text notices that can be added to Charts in order to better interpret KPIs and inform end users when something noticeable has impacted the data. You can use Annotations to indicate when you launched a new marketing campaign, when a newsletter was sent out, or when seasonal events (like special sales) may have occurred. 

By adding Annotations directly to a Chart, you're drawing a direct correlation between the work you're doing and the results you're seeing in the data. 

IN THIS ARTICLE

Which visualizations support Annotations?

Annotations are linked to a Data Souce, Metric, and specific point in time, so only visualizations that report with granularity support this functionality. Visualizations that support Annotations are Bar Charts, Line Charts, Combo Charts, Multi-Tab Charts, and Heat Maps.

Annotations will be visible on all other supported Charts that have the same Data Source, Metric, and Date Range selected. Learn more about visualization types available in Databox here

How to add an Annotation

1
 Open the Databoard where you want to add an Annotation in the Designer. This Databoard must have a supported visualization on it in order to add an Annotation
2
 Hover over the place on the Line Chart, Bar Chart or Heat Map where you want to add your Annotation. Click Annotate
3
 Type your Annotation directly into the textbox
4
 Click the green Annotation icon to save the Annotation. This Annotation is now linked to the Data Source, Metric, and point in time. 
The Annotation will be visible in the Databox app and the Streaming URL by hovering over the specified place on the Line or Bar Chart. It will also be visible anywhere the live Databoard is embedded using the HTML code. On Line Charts and Bar Charts, this point will be marked by the Annotation icon along the x-axis of the Databoard.

How to edit an Annotation

1
 Open the Databoard where you want to edit an Annotation in the Designer
2
 Hover over the place on the Line Chart, Bar Chart or Heat Map where the Annotation is located. Click on the gray Edit text at the bottom right of the existing Annotation. 
3
 Edit your Annotation directly in the textbox
4
 Click the green  Annotation icon to save the updated Annotation. This Annotation is now linked to the Data Source, Metric, and point in time. 

How to delete an Annotation

1
 Open the Databoard where you want to delete an Annotation in the  Designer
2
 Hover over the place on the Line Chart, Bar Chart or Heat Map where the Annotation is located. Click on the gray  trash icon at the bottom right of the existing Annotation. 
Your Annotation is now deleted. 

Additional Information

IN THIS SECTION

Who can view Annotations? 

In the Databox app, any user that has the permissions to view a Databoard can view any Annotations on the Databoard as well. Users that have the permissions to edit a Databoard can also edit any Annotations on the Databoard. 

Outside of the Databox app, Annotations are visible on the Streaming URL and anywhere the live Databoard is embedded using the HTML code. Anyone that has access to the Streaming URL or embedded Databoard(s) will be able to view any Annotations added to the Databoard(s). 

Will I see Annotations if I change the Granularity setting on the Chart? 

When you add an Annotation to a Chart that displays data with daily granularity, the Annotation is saved on that day at 00:00. Therefore, if you change the granularity setting to hourly, the Annotation will be visible at the beginning of the day. If you change the granularity setting to monthly, the Annotation will no longer be visible. 

Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.

Still need help? Contact Us Contact Us