All Products
Search
Document Center

Quick BI:Horizontal Bar Chart

Last Updated:Jun 03, 2026

A horizontal bar chart shows data distribution across a two-dimensional dataset. One axis represents categories, the other represents values — for example, product sales by month.

Overview

  • Use Cases

    Compares values across groups. Bar length represents value, making differences easy to identify at a glance.

  • Benefits

    • Computational capabilities: One-click period-over-period comparisons, cumulative calculations, intelligent reference lines, and trendlines.

    • Visualization effects: Supports horizontal bar, stacked, and 100% stacked chart types. Configurable data labels, legends, and overview axis.

  • Exampleimage

Limitations

  • Prerequisites: You have created a dashboard.

  • A horizontal bar chart consists of the value axis/measure, category axis/dimension, and color legend fields:

    • The value axis corresponds to the measures in your data. You must add at least one measure, such as order quantity or profit amount.

    • The category axis corresponds to the dimensions in your data. You must add at least one dimension, such as province or product type.

    • The color legend corresponds to a dimension in your data. You can add a maximum of one dimension, such as shipping method.

      Note

      You can use the color legend only when one measure field is added to the value axis.

    • The split corresponds to a dimension in your data. You can add a maximum of one dimension, such as product type.

Configure Chart Data

  1. On the Data tab, select the dimension and measure fields that you need.

    • From the Dimensions list, find city and add it to the category axis/dimension field.

    • From the Dimensions list, find product_type and add it to the color legend/dimension field.

    • From the Measures list, find shipping_cost and add it to the value axis/measure field.

      Note

      You can drag the same field into both the category axis and color legend fields to assign a unique color to each dimension value. The chart rendering varies depending on the configuration:

      • If the category axis and value axis each contain only one field, the number of bars equals the number of unique values in the category axis dimension.image

      • If the value axis contains multiple measure fields, the chart displays the first measure by default. You must open the field filter panel to switch to other measures.image

      • If the category axis contains multiple dimension fields, the number of bars is the product of the number of unique values in each dimension. For example, in the following figure, the number of bars equals the number of regions multiplied by the number of order_levels.image

  2. Click Update. The system automatically updates the chart.image

  3. (Optional) To view data for only certain cities in the city field, set a filter.

    Set filter conditions

  4. (Optional) Auto refresh

    Automatically refreshes chart data at the interval you specify (for example, every 5 minutes).

  5. (Optional) To better visualize data trends across different dimension values, add a dimension to the split/dimension field to create facets.

    Note
    • You can add only one dimension field for splitting. Facet mode has the following limitations:

      • Fields: For the field in split/dimension, the advanced calculation feature only supports Top N and None.

      • Style: The axes do not support a dual Y-axis. The overview axis is not supported in the auxiliary display settings.

      • Analysis: Only data interaction is supported. Advanced settings, analysis alerts, annotations, and smart insights are not supported.

    • Using many facets can cause the page to lag. For optimal performance, limit the number of facets to 500 or fewer.

    image

Configure Styles

Configure the chart appearance. Common style settings are covered in Configure the chart title area.

Enter a keyword in the Search box to find a setting, or click the image..png icon to Expand/Collapse All Categories.

Bar chart search

Chart Style

Configure the horizontal bar chart appearance.

image..png

Parameter

Description

Color scheme

Sets the chart color scheme.

Chart type

Supported types: horizontal bar chart, stacked horizontal bar chart, and 100% stacked horizontal bar chart.111

Bar width

Sets bar width.

Alignment

Sets chart alignment: Left or Right.

image..png

Corner radius

Sets bar corner radius.111

Stacked, 100% stacked

Switches between horizontal bar, stacked, and 100% stacked chart types.

111

Shape fill

When Chart type is set to horizontal bar chart, you can fill bars with icons representing numerical values. Consider disabling the measure axis in this case. Fill options: Assets or Image Field.

  • Assets: Sets a different shape for each dimension value. Use built-in system assets or upload custom images.111

  • Image Field: Fills bars with images from an image field in the dataset. Grouped by the category axis dimension. If multiple images correspond to the same value, the first image is used.

    Note

    You can use the Image field only if the dataset contains an image field and the field type is image (2).

    image

You can also set the Value per shape, Number of rows, and whether to Compress layout.

  • Value per shape: The numerical value a single shape represents.

  • Number of rows: Shapes display in a single row by default. Set 1 to 5 rows.111

  • Compress layout: Compresses shapes toward the measure axis while maintaining spacing and size ratio. The value axis is no longer a meaningful reference when enabled.111

Default selection on mobile

After enabling, set the Default selection to Last global dimension value or Last dimension value of specified series.

Facet

In facet mode, configure the layout and style of chart arrangement.

Note

Facet mode is available only when a field is configured in the split/dimension field.

image

Parameter

Description

Layout style

Sets the chart layout: Single-column Comparison or Grid Distribution.

Shared axis

Controls whether charts share an axis.

111

Show separator

Shows or hides a separator line between charts.

When enabled, configure the separator color and style.111

Columns

When Layout is set to Grid Distribution, you can set the number of columns for the chart arrangement.

Default is Auto. You can also set a custom column count.111

Note
  • PC and mobile column counts are configured separately. Switch terminals using the image icon at the top of the page.

  • Columns: 1–6 for PC, 1–3 for mobile.

Min facet size

Sets the minimum width and height for each chart. Options vary by layout style.

  • Single-column Comparison or Grid Distribution with Auto Columns: You can only configure the minimum width of the facet block.

  • Grid Distribution with Custom Columns: You can configure the minimum width and height of the facet block.

Spacing

Sets row and column spacing between charts. Options vary by layout style.

  • Single-column Comparison: You can only configure the column spacing between charts.

  • Grid Distribution: You can configure the row and column spacing between charts.

Split label

Position

Sets the dimension value label position: Above chart or Below chart.111

Text

Sets the font color and style of the dimension value label.111

Alignment

Sets the dimension value label alignment.

Axes

Configure axis display. Axes are shown by default.

Select Show dual Y-axis to add an Upper X-axis option in the Axis area. Dual Y-axis takes effect only with two or more measures.

image..png

Axis

Parameter

Description

Y-axis

Show Y-axis

Shows or hides the Y-axis.

Show title and unit

Shows or hides the axis title and unit on the Y-axis.

Show axis label

Shows or hides labels on the Y-axis. You can also configure the axis label display rule and text style.

Display content

Set the displayed content to some or all dimensions.

image.png

Show tick marks

Shows or hides tick marks on the Y-axis.

Show axis line

Shows or hides the Y-axis line. You can also configure its line type, line width, and color.

Show gridlines

Shows or hides gridlines for the Y-axis. You can also configure their line type, line width, and color.

Lower X-axis

Show lower X-axis

Shows or hides the lower X-axis.

Show title and unit

Shows or hides the axis title and unit.

Show axis label

Shows or hides labels on the lower X-axis. Configure the axis label display format and text style. Format options: Auto or Custom.

  • The default mode is Auto. In this mode, the axis label inherits the data display format configuration of the measure field. If there are multiple measure fields, the format of the first field is used.

  • In Custom mode, click the image icon to configure the data format in the Data Display Format Settings dialog box. Data display format > Custom.

Show tick marks

Shows or hides tick marks on the lower X-axis.

Show axis line

Shows or hides the lower X-axis line. You can also configure its line type, line width, and color.

Show gridlines

Shows or hides gridlines for the lower X-axis. You can also configure their line type, line width, and color.

Axis value range and interval

  • You can set the Minimum/Maximum values for the lower X-axis scale range either Automatically or manually.

  • You can set a Custom Interval by step value or by the number of divisions.

100.gif

Note

Configure the Upper X-axis only when Show Dual Y-axis is selected. Parameters are the same as the Lower X-axis.

Legend

Click the image icon to enable the chart legend and configure its style.

  • PC configuration

    image.png

    Parameter

    Description

    Content

    When the category axis and color legend fields use the same dimension and Shape fill is enabled in the Chart style section, the chart displays multiple legends. You can then select which content to show in the legend.111

    Position

    Sets legend position and alignment on PC.

    • When the display position is set to Top or Bottom: you can choose left, center, or right alignment.

    • When the display position is set to Left or Right: you can choose top, center, or bottom alignment. You can also set the distance between the legend and the chart content.

    Text

    Sets legend text style on PC: font color, size, weight, and italic.

  • Mobile configuration

    image

    Parameter

    Description

    Position

    Sets legend position and alignment on mobile devices.

    • When the display position is set to Top or Bottom: you can choose left, center, or right alignment.

    • When the display position is set to Left or Right: you can choose top, center, or bottom alignment. You can also set the distance between the legend and the chart content.

    Note

    When the position is set to Top, you can enable labels under the legend. After enabling, custom alignment is not supported.

    Text

    Sets legend text style on mobile: font color, size, weight, and italic.

    Display Label Content

    When Position is set to Top, click the image icon to enable labels under the legend.

    Content

    Set the data content to be displayed in the labels under the legend. You can choose Percentage and Total.

    • Percentage: The percentage of a specific data point out of the total within the current dimension. For example, the percentage of profit amount from office supplies out of the total revenue. When you choose to display percentage data, you can also set the number of decimal places for the percentage to 0, 1, or 2 in Percentage Decimal Places.

    • Total: The sum of all measures within the current dimension. For example, the total sales amount for all regions in 2025.

    Style

    Set the layout of the labels under the legend. You can choose from the following styles:

    • Multi-line Evenly Divided: Labels are automatically arranged in an evenly divided grid based on the number of columns entered in Max columns per row and the number of rows entered in Max rows per page.image

    • Single-line Tiled: All label content is displayed in a single line.image

    • Plain Text: No icons, only text content is displayed. The text color will match the color of the corresponding measure's line in the chart.image

    Indicator display when not selected

    When Style is set to Multi-line Evenly Divided or Single-line Tiled, you can configure how the indicator appears when no legend item is selected. You can choose to display it as "-" or as Empty.

    Percentage Position

    When Percentage data is selected in Content, and Style is set to Multi-line Evenly Divided or Single-line Tiled, you can further set the display position of the percentage data. You can choose to place it Below or to the Right of the value label.

    Text Style

    When Style is set to Multi-line Evenly Divided or Single-line Tiled, you can further set the style of the Value text.

    If Percentage data is selected in the content, you can set a different format for the percentage text to distinguish it from the Value label content, enhancing the visual difference between data types.

    Show Full Text

    When Style is set to Multi-line Evenly Divided, long measure names may be truncated. If you need to display the full measure name, you can select Show Full Text.

    Show Tooltip Field

    After you select this option, the field added to the Tooltip/Measure setting will be displayed in the legend area.

    Note

    Displaying tooltip fields is not supported when splitting by dimension value (that is, when the color legend is a dimension).

Data Labels

Specify whether to show data labels and configure their style.

image

Parameter

Description

Full Display

Intelligently adjusts label positions to prevent overlap. Labels exceeding the axis area may be hidden. You can also select Allow data labels to overlap.

Position

Set the display position of the labels.

When Shape fill is enabled in the Chart style section, only Outside shape is supported.

Text

Set the style of the label text.

Tooltip

Click the image icon to enable tooltips and configure their display.

  • PC configuration

    image

    Parameter

    Description

    Display Mode

    Set how the tooltip information is displayed. You can choose By single data point or By dimension value.

    Content

    Select the data content to display in the tooltip. The available options vary based on the display mode:

    When the display mode is By single data point, Percentage is supported. When the display mode is By dimension value, Total and Percentage are supported.

    • Percentage: The percentage of a specific data point out of the total within the current dimension. For example, the percentage of profit amount from office supplies out of the total revenue. When you choose to display percentage data, you can also set the number of decimal places for the percentage to 0, 1, or 2 in Percentage Decimal Places.

    • Total: The sum of all measures within the current dimension. For example, the total sales amount for all regions in 2025.

    Background Color

    Set the background fill color of the tooltip box.

    Text

    Set the style of the text in the tooltip box, including font color, size, weight, and whether it is italicized.

  • Mobile configuration

    image

    Parameter

    Description

    Floating Bubble

    Click the image icon to enable the floating bubble display (①).

    Content

    Set the data content to display in the floating bubble. You can choose Percentage or Total.

    • Percentage: The percentage of a specific data point out of the total within the current dimension. For example, the percentage of profit amount from office supplies out of the total revenue. When you choose to display percentage data, you can also set the number of decimal places for the percentage to 0, 1, or 2 in Percentage Decimal Places.

    • Total: The sum of all measures within the current dimension. For example, the total sales amount for all regions in 2025.

    Background Color

    Set the background fill color of the floating bubble.

    Text

    Set the style of the text in the floating bubble, including font color, size, weight, and whether it is italicized.

    Show Axis Dimension

    Click the image icon to enable the axis dimension display (②).

    Background Color

    Set the background fill color of the axis dimension label.

    Text

    Set the style of the axis dimension label text, including font color, weight, and whether it is italicized.

Series Settings

Configure series display style.

image

Note

You only need to set the alias and numeric display format in Series Settings if Color Legend/Dimension is enabled in the Field configuration panel.

Parameter

Description

Select series

Select a dimension or measure item based on your business scenario.

Alias

Set a field name that aligns with your business scenario.

This item can be configured only when color legend/dimension is configured.

Show data labels

Choose whether to display data labels and set their position and text format.

Series number formatting

Configure the display format for series values. You can select Auto or Custom.

This item can be configured only when color legend/dimension is configured.

Show extrema

Specifies whether to show labels for the extreme values in the chart. After you select this option, you can set the position of the extreme value labels, the display content (maximum/minimum value), the label background fill color, and the label text style.

Note

This feature is not supported for stacked and 100% stacked charts.

Auxiliary Display

Configure the metric filter and view controls.

image

Parameter

Description

Enable metric filter

Enables the in-chart metric filter. Set the default selected metric field after enabling.

View control

If the data on a chart axis is too dense to fit in the container, click the image icon to enable chart view controls. These controls allow users to interactively adjust the visible data range.

You can use the following two control types to manage the visible range on the chart axis: overview axis and scroll bar.

  • If you select overview axis, a simplified trend chart of the full dataset (the overview axis) is displayed at the bottom of the chart. Report viewers can drag the selection area to quickly browse all data or focus on a specific range. The overview axis uses an absolute coordinate system, meaning the selected interval directly corresponds to a fixed number of data items on the actual axis. It is suitable for comparative analysis or complex scenarios requiring direct navigation.imageBy default, the overview axis is displayed only when the amount of data exceeds the display width of the chart container. If you want the overview axis to be always visible, you can select Always show. After selection, the overview axis will always be displayed, even if the chart data does not fill the screen.

  • If you select scroll bar, a horizontal scroll bar is displayed on the right side of the chart. Report viewers can drag the slider horizontally to move the view window left and right. The scroll bar uses a relative scale, where the slider's length and position are determined by the ratio of the visible window to the total data range. It is suitable for general browsing scenarios.imageYou can further set the minimum category width for the scroll bar to limit the amount of data in the current chart window. This ensures that the chart content is clearly displayed in the visible area and avoids visual clutter from overlapping data labels or overly dense data points. The default minimum category width is 32px, with a value range of 16-100px.

    After setting the minimum category width, the scroll bar will appear when the actual category width allocated to the chart for full display is less than this value. When the scroll bar is enabled, chart elements and data labels are constrained within the rectangular area of the coordinate system. Any parts that extend beyond this area (such as marker points or data labels) will be automatically truncated or repositioned to fit.

Note
  • If no view control is configured and the chart size is too small, the system automatically enables a view control. By default, the system selects the overview axis, which is displayed only when the amount of data exceeds the display width of the chart container.

  • The view control feature is not supported in facet mode.

Analysis Configuration

Section

Parameter

Description

Data interaction

Drill-down

If you have configured drill-down fields, you can set the display style for drill-down levels.

Linkage

Use chart linkage to associate multiple charts for cross-chart data analysis. Configure and display linkage.

Hyperlink

Link multiple dashboards for cross-dashboard data analysis. Two types: Parameter Hyperlink and External Link. Hyperlink Configuration and Display.

Analysis alerts

Reference line

Compare current measure values against a fixed or calculated value (average, maximum, minimum, or median). Reference lines.

Trendline

Shows the overall trend of current data. Types: Intelligent Recommendation, Linear, Logarithmic, Exponential, Polynomial, and Power Function. Trendlines.

Annotation

-

Highlight abnormal or noteworthy data points using color, icons, comments, or data point markers. Annotations.

Next Steps

  • To let others view your dashboard, share it with specific users. For more information, see Share a dashboard.

  • Integrate your dashboard into a PC data portal to build a complex navigation menu for related topics.