Adding a data label

Contents[Hide]

1. Overview

A data label is a data-driven text label that you can add to views including dashboards and reports.

Data is also visualized as text using a data label automatically when you drag it directly onto a report, scorecard, or small multiple.

2. On a dashboard

As an example, create a new dashboard based on the Blank template.

Click Data Visualization in the toolbar, then click Data Label.

Add a data label from the toolbar
Add a data label from the toolbar

From the Explore window, drag a column, measure, or hierarchy and drop it onto the empty data label.

Dragging a measure to the data label
Dragging a measure to the data label

You can format measures using metric set options in the Data Analysis Panel, which you can open from the toolbar or context menu.

Click the LineTotal measure to edit it and click Define text formatting. Type $ in the Symbol field.

Submit the dialogs and switch to View mode, where you can hover over the text (or long-tap) to see its tooltip.

View the data label
View the data label

When adding more than one column, measure, or hierarchy to a data label, you can customize which ones are displayed in its text and tooltip in the Data Analysis Panel's Visualization tab.

3. In reports, scorecards, and small multiples

While designing a report, scorecard, or small multiple, drag any column, measure, or hierarchy from the Explore window to any region.

Using a data label to display Product hierarchy values in a report
Using a data label to display Product hierarchy values in a report

The data will automatically appear as text in a data label.

You can also add a data label yourself from the toolbar and then add data, the same way as described above for dashboards.

Tip
When you drag data directly to the canvas to create data labels, they all retrieve their data using the same group metric set by default to improve performance. For details, see Design tips for reports and scorecards.

4. Properties

4.1. Text and tooltip

You can further customize how text appears in the data label and its tooltip in the Properties window's Text tab, using the Label Text and Tooltip Text properties.

Text and Tooltip properties for a data label
Text and Tooltip properties for a data label

You can combine values from your data with regular text using keywords in square brackets as placeholders for the data, as suggested in the dropdown that appears while editing the text.

Custom formats can optionally be added to the keywords as described in Formatting text.

4.2. Padding

Click Layout and expand the Padding property. This property is useful for lining up data labels and static labels (which also have this property) in the repeating body of a scorecard or report.

Padding property for a data label
Padding property for a data label

4.3. Animation

When a measure displayed by a data label changes value (e.g., at the data source), the data label can be animated with a highlight color for a brief duration. This can help bring the data change to the attention of the user.

To use this feature, open the Data Analysis Panel for the data label and click Edit. Make sure the Bypass Data Cache option is checked so that the latest data is used.

Go to Properties for the data label and set a value for the Data Auto Refresh Interval (seconds) property, such as 10 seconds.

Then go to the Look section and scroll down to find the Highlight Measure Value Changes property. Enable it and optionally change the highlight color or duration of the animation (i.e., duration for the highlight color to appear and then fade away in milliseconds).

Highlight Measure Value Changes property
Highlight Measure Value Changes property

Switch to View mode and effect a change in the data to see the animation. The data label will be highlighted in color which then fades away after the specified duration.

Data label is highlighted after a change in measure value is detected
Data label is highlighted after a change in measure value is detected

4.4. State styles

Go to Look Properties to edit or add a state style for a data label when you've defined states in your metric set.

Use these properties to change various properties for the data label when the data falls within each state, including the background, border, font, or the displayed text.

State style properties for a data label
State style properties for a data label

4.5. Allow HTML formatting

By default, if your data contains HTML tags such as <b> or <i>, these will be displayed as just tags in the data label and not interpreted as HTML elements. 

If you want the HTML tags to be rendered as HTML by the browser, or if you want to enter your own HTML formatting into the Text property, go to Properties for your data label and enable the Allow HTML Formatting option.

4.6. Data brushing

Go to Look Properties to edit or add background and font color. These properties will be applied when a user hovers over the data label during view mode.

Hover over background and color properties
Hover over background and color properties

View and hover over the data label
View and hover over the data label

4.7. Fitting text

Text that does not fit in the data label is set to Truncate using an ellipsis (...) by default. This can be changed using the Overflow property in the Text tab to other options such as Hidden .

Truncated text
Truncated text

In reports, scorecards, and small multiples, the Auto Expand To Fit property is available in the Main tab of the Properties window.

When this option is enabled, the data label can automatically expand in height as necessary to fit longer text, and push content below it down to prevent overlap.

5. See also

 

Dundas Data Visualization, Inc.
500-250 Ferrand Drive
Toronto, ON, Canada
M3C 3G8

North America: 1.800.463.1492
International: 1.416.467.5100

Dundas Support Hours:
Phone: 9am-6pm, ET, Mon-Fri
Email: 7am-6pm, ET, Mon-Fri