{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["availability","img","callout","faq","faq-item","partial"]},"type":"markdown","userRole":"All user roles","accountType":"All accounts","plan":"All subscription plans"},"seo":{"title":"Annotate your charts","description":"Add context to charts by marking key events — campaign launches, outages, or milestones — directly where they appear in the data.","siteUrl":"https://help.databox.com","llmstxt":{"title":"Databox Knowledge Base","description":"Databox is a business analytics platform that consolidates data in one place, enabling real-time performance tracking and insights by mixing and matching data from various sources for a comprehensive view.","details":{"content":"This knowledge base covers everything from account setup and integrations to building Databoards, creating custom metrics, and using AI-powered features."},"sections":[{"title":"General","includeFiles":["docs/general/*.md","docs/general/visualization-types/*.md","docs/general/templates/*.md"],"excludeFiles":[]},{"title":"AI","includeFiles":["docs/ai/*.md"],"excludeFiles":[]},{"title":"Account Management","includeFiles":["docs/account-management/**/*.md"],"excludeFiles":[]},{"title":"Databoards","includeFiles":["docs/databoards/**/*.md"],"excludeFiles":[]},{"title":"Data Management","includeFiles":["docs/data-management/**/*.md"],"excludeFiles":[]},{"title":"Metrics","includeFiles":["docs/metrics/**/*.md"],"excludeFiles":[]},{"title":"Forecasts","includeFiles":["docs/forecasts/*.md"],"excludeFiles":[]},{"title":"Goals","includeFiles":["docs/goals/*.md"],"excludeFiles":[]},{"title":"Reports","includeFiles":["docs/reports/*.md"],"excludeFiles":[]},{"title":"Notifications","includeFiles":["docs/notifications/*.md"],"excludeFiles":[]},{"title":"Pricing and Billing","includeFiles":["docs/pricing-and-billing/*.md"],"excludeFiles":[]},{"title":"Mobile","includeFiles":["docs/mobile/*.md"],"excludeFiles":[]},{"title":"Support","includeFiles":["docs/support/*.md"],"excludeFiles":[]},{"title":"Integrations","includeFiles":["docs/integrations/**/*.md"],"excludeFiles":[]}],"hide":false,"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"annotate-your-charts","__idx":0},"children":["Annotate your charts"]},{"$$mdtype":"Tag","name":"Availability","attributes":{"users":"all","accounts":"all","plans":"all"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["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."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"supported-charts-and-permissions","__idx":1},"children":["Supported charts and permissions"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Annotations require chart types that report with time-based granularity. They are supported on ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/understanding-the-line-visualization"},"children":["line"]},", ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/understanding-the-bar-visualization"},"children":["bar"]},", ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/understanding-the-combo-visualization"},"children":["combo"]},", and ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/understanding-the-heatmap-visualization"},"children":["heatmap"]}," visualizations."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["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."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"add-an-annotation","__idx":2},"children":["Add an annotation"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Open a Databoard that contains a supported visualization."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Hover over the x-axis at the point in time where you want to add the annotation. A ",{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/annotation.c2d4844c0a56d87314c4f64cbfd11f2c356fb43b7899d008d1dd16aad423c88c.419bb737.svg","alt":"annotation"},"children":[]}," icon appears on the axis."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["+"]}," to open the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Add Annotation"]}," dialog."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Set the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["date"]}," and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["time"]}," for the annotation. The timezone shown below the date field reflects your general data source timezone."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enter a description in the text field. You can include a URL — it becomes a clickable link once the annotation is saved."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["(Optional) Check ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["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."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Save"]},"."]}]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/annotate-your-charts_1.a6248521d7a2753214c1d23f58d900d013e5d44d25077a7d4abaacff28914107.ba843e8f.png","alt":"add-annotation-dialog","withLightbox":true,"className":"ss-img"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"view-annotations","__idx":3},"children":["View annotations"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["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."]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/annotate-your-charts_2.991592acedc697944ef41064c653f1bc22eb6f284919210031746406bb369674.ba843e8f.png","alt":"annotation-markers-on-bar-chart","withLightbox":true,"className":"ss-img"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"edit-an-annotation","__idx":4},"children":["Edit an annotation"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click the annotation marker on the chart to open the annotation popup."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Edit"]}," in the popup."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Update the description or any other fields."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Save"]},"."]}]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/annotate-your-charts_3.abc0edd148661cc8559e72a429d724e671af38d2b86ef43a6f090d356363c3e2.ba843e8f.png","alt":"annotation-popup-with-edit-option","withLightbox":true,"className":"ss-img"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"delete-an-annotation","__idx":5},"children":["Delete an annotation"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click the annotation marker on the chart to open the annotation popup."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["trash"]}," icon to delete the annotation."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"Callout","attributes":{"type":"warning"},"children":["Annotations are deleted without a confirmation prompt. Make sure you're deleting the right annotation before confirming, as it cannot be restored."]}]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/annotate-your-charts_4.8df0875323d134bfc91f22c3e8c66624ead6562233c061559cc2031ab7ee2160.ba843e8f.png","alt":"annotation-popup-with-delete-option","withLightbox":true,"className":"ss-img"},"children":[]},{"$$mdtype":"Tag","name":"Faq","attributes":{},"children":[{"$$mdtype":"Tag","name":"FaqItem","attributes":{"question":"What happens to annotations if I change the chart's granularity?"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["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."]}]},{"$$mdtype":"Tag","name":"FaqItem","attributes":{"question":"Will an annotation appear on other charts if I don't check 'View on specific metric only'?"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["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."]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[" "]},{"$$mdtype":"Tag","name":"Cards","attributes":{"columns":4,"cardMinWidth":160},"children":[{"$$mdtype":"Tag","name":"FooterCard","attributes":{"title":"Ask Genie","icon":"genie","to":"https://app.databox.com/genie","variant":"elevated"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Get instant answers or help with your data using the in-app AI assistant."]}]},{"$$mdtype":"Tag","name":"FooterCard","attributes":{"title":"Talk to an expert","icon":"assistance","to":"https://meetings.hubspot.com/databox-meeting/account-management","variant":"elevated"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For customers: Get help with your setup, strategy, or making the most of Databox."]}]},{"$$mdtype":"Tag","name":"FooterCard","attributes":{"title":"Book a demo","icon":"eye-open","to":"https://meetings.hubspot.com/databox-meeting/ref-knowledge-base","variant":"elevated"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["New to Databox? See how it works and get guidance on getting started."]}]},{"$$mdtype":"Tag","name":"FooterCard","attributes":{"title":"Send an email","icon":"help","to":"mailto:help@databox.com","variant":"elevated"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Reach out to support for help with your account, data, or technical issues."]}]}]}]},"headings":[{"value":"Annotate your charts","id":"annotate-your-charts","depth":1},{"value":"Supported charts and permissions","id":"supported-charts-and-permissions","depth":2},{"value":"Add an annotation","id":"add-an-annotation","depth":2},{"value":"View annotations","id":"view-annotations","depth":2},{"value":"Edit an annotation","id":"edit-an-annotation","depth":2},{"value":"Delete an annotation","id":"delete-an-annotation","depth":2}],"frontmatter":{"slug":"annotate-your-charts","seo":{"title":"Annotate your charts","description":"Add context to charts by marking key events — campaign launches, outages, or milestones — directly where they appear in the data."},"keywords":{"includes":["annotations","chart annotations","add annotations to charts","annotate Databox chart","mark events on dashboard","Databox annotations"]},"metadata":{"userRole":"All user roles","accountType":"All accounts","plan":"All subscription plans"}},"lastModified":"2026-05-01T13:34:47.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/annotate-your-charts","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}