All Products
Search
Document Center

Quick BI:Bubble Charts

Last Updated:Oct 30, 2025

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

image

Configure Data

  1. In the Charts section of the widget library, drag Bubble Chart to the canvas.image

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

    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.

    Note

    You 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.

    Note

    You 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:image

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 (⑥).

image

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.

    image

    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.111

    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.

    111

    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 (2).

    When you upload a custom image or use an image field, you can also set the image shape and display mode.image

    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.image

    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.111

    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.111

    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.image

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.

  • Maximum Value: Sets the maximum value for the x-axis. The default is Auto. You can enter a value manually as needed. If the entered value is less than the maximum value of the measure field, it will not take effect.

  • Minimum Value: Sets the minimum value for the x-axis. The default is Auto. You can enter a value manually as needed. If the entered value is greater than the minimum value of the measure field, it will not take effect.

  • Custom Interval: Sets the interval between tick marks on the x-axis. You can set it By Step Size or By Number of Divisions.

    • By Step Size: Manually enter the difference in value between two adjacent tick marks on the x-axis.

    • By Number of Divisions: Divides the x-axis into a specified number of equal parts. You can enter the number of divisions, and the system will automatically distribute the tick marks evenly on 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.

  • Maximum Value: Sets the maximum value for the left y-axis. The default is Auto. You can enter a value manually as needed. If the entered value is less than the maximum value of the measure field, it will not take effect.

  • Minimum Value: Sets the minimum value for the left y-axis. The default is Auto. You can enter a value manually as needed. If the entered value is greater than the minimum value of the measure field, it will not take effect.

  • Custom Interval: Sets the interval between tick marks on the left y-axis. You can set it By Step Size or By Number of Divisions.

    • By Step Size: Manually enter the difference in value between two adjacent tick marks on the left y-axis.

    • By Number of Divisions: Divides the left y-axis into a specified number of equal parts. You can enter the number of divisions, and the system will automatically distribute the tick marks evenly on the left y-axis.

Legend

In the Legend section, you can configure the legend items, position, and text style.image

Data Labels

In the Data Labels section, you can perform the following operations.

image

  • 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.

Note

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.image

Note

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.image

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:image

  • 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.