A bubble chart is a data visualization that shows the relationship between multiple variables. It uses the position and size of bubbles in a two-dimensional coordinate system to display data. This topic describes how to add data to a bubble chart and configure its style.
Example

Configure Data
In the Charts section of the widget library, drag Bubble Chart to the canvas.

On the Data panel, select a dataset. On the Fields tab, configure the chart fields as described in the following table.

Field
Description
X-axis/Dimension or Measure
Configures the data for the x-axis. You can drag a dimension or measure field to this section.
In the example, the Order amount field is used. This means the position of each bubble on the x-axis depends on its order amount.
Y-axis/Measure
Configures the data for the y-axis. Only measure fields are supported. The y-axis works with the x-axis to determine the exact position of each bubble in the coordinate system.
In the example, the Profit amount field is used. This means the position of each bubble on the y-axis depends on its profit amount.
Category/Dimension
Configures the dimension used to categorize the data. This lets you compare and observe the distribution of different data categories.
In the example, the Region field is used. This means the data is grouped by region.
Color/Dimension or Measure
Configures the field that determines the bubble color. You can drag a dimension or measure field to this section. You can then customize the bubble colors in the Plotting Area > Color Settings section on the Style tab.
NoteYou can configure this field only if a field is already present in the Category/Dimension section.
If you use a dimension field, a different bubble color is generated for each dimension value. For example, if you use the Region field, bubbles for the Northeast region are displayed in blue.
If you use a measure field, a color gradient is generated based on the trend of the measure values. For example, if you use the Order quantity field, the bubble color changes from dark to light based on the order quantity.
In the example, the Region field is used. This means different bubble colors represent different regions.
Shape/Dimension
Configures the field that determines the bubble shape. Only dimension fields are supported. You can customize the bubble shape in the Plotting Area > Bubble Style section on the Style tab.
NoteYou can configure this field only if a field is already present in the Category/Dimension section.
In the example, the Product type field is used. This means different bubble shapes represent different product types.
Size/Measure
Configures the field that determines the bubble size. Only measure fields are supported. The system generates the bubble size based on the measure value.
In the example, the Order quantity field is used. This means the bubble size is determined by the order quantity.
Playback Axis/Time Dimension
If your data includes time information, you can drag a time field here to create a dynamic bubble chart that changes over time.
This is not used in the example.
Tooltip/Measure
When a report viewer hovers the mouse pointer over a bubble, a tooltip appears to provide more details about that data point, such as the specific value of a measure. You can configure the specific measure information to display in the tooltip.
In the example, the Shipping cost field is used. This means the shipping cost for the data point is displayed in the tooltip.
You can also perform the following data operations:

Configure field formats in batches (①). For more information, see Configure field styles in batches.
Filter fields (②). For more information, see Filter data.
Set up auto-refresh for data (③). For more information, see Refresh data on a schedule.
Switch datasets (④). For more information, see Switch datasets.
Edit the dataset (⑤). For more information, see Edit a dataset.
Process data (⑥). For more information, see Create a calculated field, Create a new grouped dimension, and Placeholders.
Copy a field (⑦). For more information, see Copy and convert to a dimension.
Configure Styles
Position and Size
You can configure the following settings for the widget:
Adjust the widget alignment (①). Options include align left, center, and align right.
Adjust the widget position (②). Set the X and Y coordinate values, using the upper-left corner as the origin.
Adjust the widget angle (③). Set the rotation angle.
Adjust the widget size (④). Set the width (W) and height (H) of the widget.
Lock the widget (⑤). When a widget is locked, its size cannot be adjusted.
Set the opacity of the widget (⑥).

Plotting Area
In the Plotting area section, you can configure the Color Scheme, Bubble Style, and Enable Four Quadrants settings. The available configuration items vary depending on the fields that are configured in the Fields tab.
If a field is configured in the Shape/Dimension section, the following settings are available.

Configuration item
Description
Color Settings
Sets the overall color scheme for the bubbles in the chart. You can select a built-in system theme and customize the color for individual dimension values.

When a measure field is configured in the Color/Dimension Or Measure section, you must set the Data Mapping Range and Color Scheme for the measure.

Fill Opacity
Sets the opacity of the bubbles.
Bubble Style
Sets the style of the bubble shapes. You can select from materials or use an image field.
Material: Set a different shape pattern for each dimension value. You can select from built-in materials or upload a custom image.
Image field: Uses images from an image field in the dataset as the fill. You can use the Image Field option only if the dataset contains an image field and the field type is image (
).
When you upload a custom image or use an image field, you can also set the image shape and display mode.

Bubble Size
Sets the size of the bubbles.
Show Border
Sets whether to show a border for the bubbles.
Show Shadow
Sets whether to show a shadow for the bubbles.
Four Quadrants
You can enable the Four Quadrants feature when both the x-axis and y-axis fields are measure fields.
If no field is configured in the Shape/Dimension section, the following settings are available.

Configuration item
Description
Color Settings
Sets the overall color scheme for the bubbles in the chart. You can select a built-in system theme and customize the color for individual dimension values.

When a measure field is configured in the Color/Dimension Or Measure section, you must set the Data Mapping Range and Color Scheme for the measure.

Fill Opacity
Sets the opacity of the bubbles.
Bubble Style
Sets the shape style for all bubbles in the chart. You can select a built-in icon or upload a custom image. When you upload a custom image, you can also set the image Shape and Display Mode.
Bubble Size
Sets the size of the bubbles.
Show Border
Sets whether to show a border for the bubbles.
Show Shadow
Sets whether to show a shadow for the bubbles.
Four Quadrants
You can enable the Four Quadrants feature when both the x-axis and y-axis fields are measure fields.
Axes
In the Axes section, you can perform the following operations.
Name | Configuration item | Description |
X-axis | Show X-axis | Sets whether to show the x-axis. |
Show Title And Unit | Sets whether to show the Axis Title and Unit on the x-axis. | |
Show Axis Labels | Sets whether to show labels on the x-axis. | |
Axis Label Display Format Settings | Sets the display format for axis labels. Options include Auto, Custom Format, and Manual Input. Note You can also batch configure the display format for measures on the Data page. For more information, see Configure chart fields. | |
Show Tick Marks | Sets whether to show tick marks on the x-axis. | |
Show Axis Line | Sets whether to show the axis line. You can configure the line type, width, and color. | |
Show Gridlines | Sets whether to show gridlines for the x-axis. You can configure the line type, width, and color. | |
Axis Value Range and Interval | Sets the value range (maximum and minimum) and the interval between tick marks for the x-axis.
| |
Left Y-axis | Show Left Y-axis | Sets whether to show the left y-axis. |
Show Title And Unit | You can set the position of the Axis Title and Unit. Options include Outside Axis and Above Axis. | |
Show Axis Labels | Sets whether to show labels on the axis. | |
Axis Label Display Format Settings | Sets the display format for axis labels. Options include Auto, Custom Format, and Manual Input. Note You can also batch configure the display format for measures on the Data page. For more information, see Configure chart fields. | |
Show Tick Marks | Sets whether to show tick marks on the left y-axis. | |
Show Axis Line | Sets whether to show the axis line. You can configure the line type, width, and color. | |
Show Gridlines | Sets whether to show gridlines on the axis. You can configure the line type, width, and color. | |
Axis Value Range and Interval | Sets the value range (maximum and minimum) and the interval between tick marks for the left y-axis.
|
Legend
In the Legend section, you can configure the legend items, position, and text style.
Data Labels
In the Data Labels section, you can perform the following operations.

Show Data Labels: Sets whether to display data labels in the chart.
Show All: Sets whether to display all data labels. If the chart has many measure values, we recommend that you do not select this option. In this case, the system displays only some data labels to prevent the chart from becoming cluttered.
Position: Sets the display position of the data labels.
Text: Sets the style of the data label text, including font color and size.
The Position cannot be adjusted when a field is added to the Playback Axis/Time Dimension section.
Tooltip
When a user hovers the mouse pointer over a bubble, a tooltip is displayed. In this section, you can configure the background color and text style for the tooltip.
The fields displayed in the tooltip are configured in the Tooltip/Measure section on the Fields tab.
Series Settings
In the Series Settings section, you can configure the display style for a specific dimension value in the chart.
Auxiliary Display
If a time field is added to the Playback Axis/Time Dimension section on the Fields tab, you can configure the Playback Axis in the Auxiliary Display section:
Select Autoplay On Page Load to automatically play the chart animation once when the report loads.
Select Loop Playback to play the chart animation in a loop.
Select Show Current Time Value to display the corresponding time as the chart animation plays.
Select Enable trail rendering to draw the trail of a bubble when it is clicked. The trail follows the playback axis sequence.