How to add data to a heatmap and configure its styles-Quick BI(Quick BI)-阿里云帮助中心

Prerequisites

You have created a dashboard. For more information, see Create a dashboard.

Chart overview

Use cases

Heatmaps are commonly used in models such as market basket analysis.

Benefits

Two visualization styles are available: standard heatmap and polar heatmap.

Example

Configure chart fields

On the Fields tab on the right side of the chart, select the dimension and measure fields.
- In the Dimensions list, find the Province field. Double-click the field or drag it to the X-axis/Dimension area to use it as the x-axis.
- In the Dimensions list, find the Product Type field. Double-click the field or drag it to the Y-axis/Dimension area to use it as the y-axis.
- In the Measures list, find the Order Amount field. Double-click the field or drag it to the Heat Depth area to set the color intensity of the heatmap.
- (Optional) To represent data values by the size of heat blocks, drag a measure field to the Shape Size/Measure area.
Click Update. The system automatically updates the chart.
(Optional) To view data for specific provinces, set a filter.

For more information about field filtering, see Filter chart fields.
Auto-refresh

When enabled, chart data is automatically refreshed at the specified interval. For example, a 5-minute interval refreshes the chart every 5 minutes.

Configure chart styles

For information about Title and Card style settings, see Configure the title area of a chart.

Heatmap area

In the Heatmap area section, configure settings such as visualization style, data mapping range, heat color, and opacity.

Parameter	Description
Visualization style	Two styles are available: standard heatmap and polar heatmap.
Color settings	If a dimension field is added to the Heat Depth area of the Fields panel, you can set a color for each dimension value.
Data mapping range	Three range types are supported: Equal Interval Range, Continuous Range, and Custom Range. Equal Interval Range You can specify 2 to 10 intervals. Continuous Range This range type is selected by default. Custom Range You can specify 2 to 10 intervals. The range can be divided based on absolute values or percentages, with a specified minimum and maximum value.
Heat color	Two gradient types are available: Sequential Gradient and Diverging Gradient.
Opacity	Sets the opacity, ranging from 0% to 100%.
Show split line	Shows or hides split lines between heat blocks and sets their color.
Heat block shape	If a field is added to the Shape Size/Measure area in the Fields panel, you can configure the Shape Size of the heat blocks.
Heat block spacing	Sets the spacing between heat blocks. Valid values: 0 to 20 px. Note This setting is only available for standard heatmaps.
Heat block corner radius	Sets the corner radius of heat blocks. Valid values: 0 to 20 px. Note This setting is only available for standard heatmaps.
Outlier handling	You can hide or customize the display of outliers.

Axis

In the Axis section, configure the axis styles.

Note

The following settings apply to the axes of a standard heatmap. For a polar heatmap, you can only configure Show Outer Axis Label and Show Inner Axis Label.

Name	Parameter	Description
X-axis	Show x-axis	Shows or hides the x-axis.
	X-axis position	Sets the x-axis position to the top or bottom of the chart.
	Show title and unit	Shows or hides the title and unit for the x-axis.
	Show axis label	Shows or hides labels for the x-axis and configures the axis label display rule and text style. The display rules include Smart Display, Force Sparse, and Show at Most.
	Show tick marks	Shows or hides tick marks on the x-axis.
	Show axis line	Shows or hides the x-axis line and configures its style, including line type, width, and color.
Left y-axis	Show left y-axis	Shows or hides the left y-axis.
	Show title and unit	Shows or hides the title and unit for the y-axis.
	Show axis label	Shows or hides labels for the left y-axis and configures the axis label display rule and text style.
	Show tick marks	Shows or hides tick marks on the left y-axis.
	Show axis line	Shows or hides the left y-axis line and configures its style, including line type, width, and color.

Legend

In the Legend section, click the icon to enable the chart legend and configure its style.

Parameter	Description
Legend type	When the data mapping range in the Heatmap area section is set to Equal Interval Range or Custom Range, you can select a legend type. Supported types include Continuous, Categorical, and Block.
Content	If fields are added to both the Heat Depth and Shape Size areas in the Fields panel, you can select which field's legend to display.
Position	Sets the display position and alignment of the legend. If you set the position to Top or Bottom, you can select Left, Center, or Right alignment. If you set the position to Left or Right, you can select Top, Center, or Bottom alignment. You can also set the distance between the legend and the chart content.
Text	Sets the text format for the legend.
Mobile legend	Desktop and mobile legend settings are independent. Switch to the mobile editing view by using the desktop/mobile toggle button () at the top of the dashboard editing page to configure a separate legend for mobile devices.

Data label

In the Data label section, configure data label visibility and text style. When Visualization Style is set to standard heatmap and fields are configured in both the Heat Depth and Shape Size/Measure areas, you can also select the label content.

Tooltip

In the Tooltip section, configure the tooltip style.

Parameter	Description
Background color	Sets the background fill color of the tooltip.
Text	Sets the text style of the tooltip, including font color, size, weight, and style (italic).
Mobile tooltip	Desktop and mobile tooltip settings are independent. Switch to the mobile editing view by using the desktop/mobile toggle button () at the top of the dashboard editing page to configure the tooltip for mobile devices. Font size can be set separately for desktop and mobile, while all other style settings are shared.

Conditional formatting

In the Conditional formatting section, configure formatting rules that apply when data meets specific conditions. Click the icon under Conditional Style. In the Conditional Formatting Configuration dialog box, select the Icon option and configure the settings.

Note

Conditional formatting is only available for standard heatmaps.

Parameter		Description
Rule definition	Based on field	Select the field for which to configure conditional formatting.
	Condition type	Select the comparison method. You can compare with a fixed value or compare with a dynamic field. Compare with a fixed value: Compares the field data with a fixed numeric value. For example, "sales amount is greater than 600,000." This method is ideal for monitoring fixed thresholds. Compare with a dynamic field: Compares the field data with the value or calculated result of another field. For example, a rule could be "exceeds last month's sales by 20%". This method is useful when evaluation criteria need to be adjusted dynamically based on changing factors such as time.
	Conditional rule	Select a marker icon for the current rule and define the specific comparison logic. If the condition type is fixed value, enter the fixed value for the rule. If the condition type is dynamic field, select the specific field and calculation method for the comparison.
More settings		Sets the size of the icons displayed in the chart.

Auxiliary display

In the Auxiliary display section, configure the x-axis and y-axis sliders.

Note

Sliders are only available for standard heatmaps.

Chart analysis configurations

Parameter	Description
Drill-down	If you have configured drill-down fields in the Fields panel, you can set the display style for drill-down hierarchy rows here. For more information, see Drill-down.
Linkage	If your analysis data is in different charts, use linkage to connect them. For more information, see Linkage.
Jump	If your analysis data is in different dashboards, use jumps to connect them. Jump types include intra-product jump, intra-component jump, and external link. For more information, see Jump.