Bar Chart

In a Bar Chart, data is represented as vertical or horizontal bars, where the height or width is proportional to the displayed values. Each bar corresponds to a distinct data value or category.

Widget Settings

In addition to the common widget settings, this widget has unique configuration options.

Data Settings

The widget supports two dimension groups: Dimension 1 and Dimension 2. You can add multiple dimensions to each group. For dimensions, you can hide empty values, assign click actions, and configure the Display setting (Always / By variable / By formula). You can also add measures to the widget.

You can assign colors to dimensions and measures. Display rules applicable to the widget are defined either at the workspace level in the Data Model or in the dashboard’s indicator tab under Dashboard.

As with other widgets, you can apply sorting to the Bar Chart.

Display Settings

Text Size

Controls the text size in the widget, excluding measure Data labels.

Dimension Limits

Dimension 1 Limit and Dimension 2 Limit control the number of bars displayed on the chart.

Hide Empty Values

Enable this option to exclude empty values from the chart.

Hint

When enabled, hovering over a bar in Browse mode displays a hint with detailed information about the data. This is especially useful when the chart contains many bars and not all labels are visible.

Chart Type

Controls how bars are displayed: Stacked (default) or Grouped. When using stacked bars, you can optionally show total Data labels and adjust their text size.

Orientation

Controls the direction of the bars:

• Auto (default)
• Vertical
• Vertical-left
• Vertical-right

If the dimension uses a time-based format, the chart orientation is vertical; otherwise, it defaults to horizontal.

Bar Width

Default: Auto (20 pixels for horizontal orientation, 36 pixels for vertical). Acceptable values: 12–100 pixels. The input value is used as the maximum bar width if sufficient space is available (gaps between bars are at least as wide as the bars themselves). If space is limited, the system automatically reduces bar width to fit.

Legend

For details on legend configuration, see Widgets.

X-Axis

For the X-axis, you can enable a title and configure label rotation and height.

Y-Axis

For the Y-axis, you can enable a title and set label width.

Filtering Settings

The widget supports standard filtering settings.

Filters configured within the widget cannot be removed in Browse mode.

Widget Configuration in YAML

You can configure the widget not only visually but also in the YAML editor. The table below lists the keys and values available for configuration. For details on using the value key, see Dimension and Measure Values in YAML. Supported data formats are described on the corresponding page. General widget parameters are covered in Widget Configuration in YAML.

Data Settings in YAML

Dimension 1 (key: dimensionsFirstGroup)

Hierarchical Dimension for Dimension 1 (key: hierarchyDimensions)

Dimension 2 (key: dimensionsSecondGroup)

Hierarchical Dimension for Dimension 2 (key: hierarchyDimensions)

Measures in YAML (key: measures)

Show Value Labels (key: showLabels)

Display Settings in YAML

Total Value Labels (key: showTotalLabels)

X-Axis Settings (key: xAxis)

Y-Axis Settings (key: yAxis)

Filtering Settings in YAML

Example of a Configured Widget in the YAML Editor

- key: BAR_CHART
  apiVersion: "16"
  type: BAR_CHART
  settings:
    displayCondition:
      mode: DISABLED
    orientation: VERTICAL_LEFT
    textSize: 12
    xAxis:
      showTitle: false
      enabled: false
    ignoreFilters: false
    legend:
      position: BOTTOM
      align: CENTER
    dimensionsFirstGroup:
      - displayCondition:
          mode: DISABLED
        color:
          mode: DISABLED
        dbDataType: STRING
        name: Store
        format: STRING
        value:
          mode: FORMULA
          formula: '"store"."Store"'
        formatting: AUTO
        onClick: []
    filters: []
    showHint: true
    filterMode: DEFAULT
    yAxis:
      showTitle: false
      enabled: true
    measures:
      - displayCondition:
          mode: DISABLED
        color:
          mode: AUTO
        dbDataType: INTEGER
        name: Sales Quantity
        format: NUMBER
        value:
          mode: FORMULA
          formula: sum("sale"."Sales Quantity")
        formatting: AUTO
        valueLabel:
          size: 12
          enabled: true
        showLabels:
          enabled: true
          size: 12
      - displayCondition:
          mode: DISABLED
        color:
          mode: AUTO
        dbDataType: INTEGER
        name: Sales Quantity Plan
        format: NUMBER
        value:
          mode: FORMULA
          formula: sum("sale"."Sales Quantity Plan")
        formatting: AUTO
        valueLabel:
          size: 12
          enabled: true
        showLabels:
          enabled: true
          size: 12
    dimensionsSecondGroup: []
    sorting:
      - name: sum (Sales Quantity)
        value:
          mode: IN_WIDGET
          index: 0
          group: measures
        direction: DESC
    chartType: GROUP
    secondDimensionLimit: 50
    title: ""
    titleSize: 14
    stateName: State 1
    firstDimensionLimit: 5
    showTotalLabels:
      size: 12
      enabled: false
    titleColor:
      mode: AUTO
    titleWeight: NORMAL
    showMarkdown: false
    markdownMeasures: []
    markdownText: ""