Skip to main content
waffle.svg
Domo Knowledge Base

Adding Date Annotations

Intro

In the Details view for a KPI card with date information, you can add annotations (explanatory notes) to data points in the graph to provide context for your viewers. Each annotation appears in an Annotations sidebar, with a colored flag that allows users to quickly match the annotation with its associated data point. To add date annotations, you must have a default security role of "Editor" or above or a custom role with "Edit Cards" enabled. 

This functionality is available only for charts containing date/time data.

The following screenshot shows an example of an annotation with its matching flag. 

date_annotations_0.png

If you mouse over an annotation in the sidebar, the corresponding data point is highlighted. 

You can add annotations to as many data points in the graph as you want. 

Date annotations become a permanent part of a card when they are added. So if you leave the card then come back, the annotations will persist. Likewise, if another user opens the card, they will also see those annotations.

If you change the date grain for a card with date annotations, the annotations are matched with the data point closest to the original data point. For example, let's say a chart was set to a "Monthly" date grain and you added an annotation to the data point for the month of November. If you then switched to a weekly date grain, the annotation would be matched with the weekly data point closest to November 1st. 

Date annotations are different from "snapshot annotations." Snapshot annotations allow you to draw on a card, add simple shapes and text, and so on. For more information, see Taking Snapshots of Cards.

Training Video - Date Annotations in Cards

 

 

Note: The product training videos are for Domo customers and clients only.

Example

As an example, let's say that the company "Wetter Water" has taken on a new Marketing manager, Hannah Jukes, to oversee all future social media marketing efforts. As a brand new member of the organization, Hannah wants to know about past social media marketing efforts and the revenue they have brought into the company. To this end, one of her coworkers, Juan, shares with her the following card:
  

date_annotations_1.png  
 

This card is useful for showing the total revenue received per month, but it doesn't give Hannah any context into why some months were more or less successful than others. Without this information, Hannah can't get a feel for which campaign strategies have worked in the past and which fell short of expectations. She shares her frustrations with Juan. Luckily, he knows just what to do to provide the proper context for Hannah. He adds date annotations to the bars for those months in which marketing revenue exceeded or fell below expectations. As shown below, for each data point with an annotation, a colored flag with a letter appears to indicate the annotation. A sidebar also opens when the chart includes annotations, with each annotation appearing with its corresponding flag so viewers can associate annotations with their given date elements. 
 

date_annotations_2.png    
 

These notes help Hannah understand why things played out the way they did. For example, noting that the month of October fell below the $60 million mark, she locates the corresponding annotation in the sidebar, which indicates that the Twitter campaign for the month was successful but got off to a late start. Based on this information, Hannah deduces that it might be worth trying a similar campaign in the future.

Adding Date Annotations

You add date annotations in the Details view (not the Analyzer view) for your chart. Date annotations are available for most chart types that can display date-time data (with a few exceptions such as Calendars, Gantt charts, etc.). If a date-time column has not been applied to your chart, you cannot add date annotations. For more information about applying columns, see Applying DataSet Columns to Your Chart.

To add date annotations to your chart,

  1. Open the Details view for the chart you want to annotate.

  2. Select annotation_icon.png > Create Date Annotation.
    If no date-time column has been applied to this chart, this option is grayed out.

  3. Mouse over the date-time element (bar, line, etc.) in the chart you want to annotate. 
    When you mouse over an element, a line appears with a flag to let you know the annotation will be applied to this element.

    date_annotations_3.png

  4. Click the line for the element you want to annotate.
    A dialog appears in which you can enter the annotation and choose a flag color.

    annotations_dialog.png

  5. Enter your annotation in the field.

  6. (Optional) To change the flag color for the annotation, select a different color in the Choose a color menu.

  7. Click Save.
    The annotation appears in the sidebar, and a corresponding flag appears over the annotated element in the chart. 

  8. (Optional) Repeat the above steps to add more annotations if desired.

Note that when you add additional annotations, the automatic lettering for the flags updates automatically. So when you have just one annotation in your chart, that annotation will be denoted using the letter "A." If you then add a new annotation, that annotation becomes "A" and the original one becomes "B," and so on. Also note that annotations appear in your sidebar in reverse chronological order, with the annotations for the most recent dates showing up first. 

Hiding Annotations

You can hide date annotations, which closes the sidebar and hides the flags. This change does not persist when you close the card. Likewise, if any other users open your card, the annotations are not hidden.

To hide date annotations,

  1. Open the Details view for the chart.

  2. Select annotation_icon.png > Hide Date Annotations.

The sidebar and flags are hidden.