Component properties for the Data visualization

reference australia Updated Sep 10, 2026 4 min read we-data-viz-comp-prop.md
Raw file servicenow.com

Component properties enable you to configure the behavior of the Data visualization component instance on the third-party website.

Component property

Description

Data visualization type

Display type of data visualization chart for the component.

Show header

Option to display the visualization header, including title and icons.

Show header separator

Option to display a line separating the header from the rest of the component.

Chart title

Title for the visualization.

Description

Description for your component.

Wrap title

Option to wrap long titles onto a second line. If cleared, an ellipsis is displayed to truncate the long title.

Show border

Option to display a line around the component.

Sort by

Sorts groups or categories in the specified order. Currently, you can sort by value or name.

Sort by order

Sorts groups or categories in ascending or descending order.

Show total value

Option to show the total value.This field doesn’t apply to pie chart.

Show metric label

Option to show the metric label. This field doesn’t apply to pie chart.

Drill down label

Text displayed in the tooltip to help users understand what will happen upon selecting.

Show selected data point

Option to show the data point that has been selected. It’s commonly used when the chart functions as a filter.

Refresh requested

A value that triggers a data refresh. The refresh occurs only if the new value of this property is different from the previous one.

Show legend

Option to display the legend.

Show legend value

Option to display the value corresponding to the area of the chart you hover on. The value is displayed as a tooltip and in the chart legend.

Legend position

Position of the legend relative to the chart. Currently, you can set the location to above, below, right, or left.

Legend orientation

The orientation of the legend. Currently, you set it either horizontal or vertical.

Horizontal alignment

The horizontal alignment of elements in the legend. Currently, you can set it to start, center, or end.

Max legend item width, px

Defines number of pixels after which the item of the legend will be truncated.

Expand legend vertically

Option that enables the legend to expand as needed to fit the content without scrolling, instead of being limited to two lines.

Show data labels

Option to display the score of each data point.

Set color type

Determines the color for the chart. You can set color type to default, color palette, or fixed element color.

Component property

Description

Data visualization type

Display type of data visualization chart for the component.

Show header

Option to display the visualization header, including title and icons.

Show header separator

Option to display a line separating the header from the rest of the component.

Chart title

Title for the visualization chart.

Description

Description for your component.

Wrap title

Option to wrap long titles onto a second line. If unchecked, an ellipsis is displayed to truncate the long title.

Show border

Option to display a line around the component.

Sort by

Sorts groups or categories in the specified order. Currently, you can sort by value or name.

Sort by order

Sorts groups or categories in ascending or descending order.

Show total value

Option to show the total value.

Show metric label

Option to display the metric label.

Show score update time

Option to display the time of the last update of the single score.

Show 0 when no data available

Option to display format when there’s no value in the selected dataset or configuration.

Refresh requested

A value that triggers a data refresh. The refresh occurs only if the new value of this property is different from the previous one.

Score size

Size of the score. Currently, you can set size to auto, xs, s, m, l, xl, or xxl.

Score icon

An icon is to be shown in front of the score value. You can either search from the available images or upload custom images.

Alignment

Add icon to be shown in front of the score value

Set color type

Determines the color for the chart. You can set color type to default, or single color.

**Related topics**

Configure the Data visualization component instance

Embed the Data visualization component instance on the third-party website

Event handler in the Data visualization component

Sample code for the Data visualization component

Search documentation
Search document titles and file paths on the australia branch