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.

Reference Lines

Reference lines serve as visual guides for specified values on a chart. Detailed information on configuring and using reference lines is provided on the Widgets page.

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 in the view 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)

Reference Lines (key: referenceLines)

To add reference lines to the Y-axis, use the referenceLinesEnabled key.

Within the referenceLines block, the following keys are used:

Filtering Settings in YAML

Example of a Configured Widget in the YAML Editor

widgets:
  - key: bar-chart
    apiVersion: "17"
    type: BAR_CHART
    settings:
      titleColor:
        mode: AUTO
      titleSize: 14
      paddings: 8
      titleWeight: NORMAL
      textSize: 12
      filterMode: DEFAULT
      ignoreFilters: false
      stateName: null
      title: ""
      showMarkdown: false
      markdownMeasures: []
      markdownText: ""
      markdownTextSize: 14
      showTotalLabels:
        enabled: false
        size: 12
      xAxis:
        enabled: true
        showTitle: true
        referenceLinesEnabled: false
      yAxis:
        enabled: true
        showTitle: true
        referenceLinesEnabled: false
      firstDimensionLimit: 15
      secondDimensionLimit: 50
      dimensionsFirstGroup:
        - name: trimmed_name
          value:
            mode: FORMULA
            formula: '"phases"."trimmed_name"'
          dbDataType: String
          formatting:
            value: AUTO
            mode: BASE
          hideEmptyValues: false
          format:
            value: STRING
            mode: BASE
          onClick: []
          displayCondition:
            mode: DISABLED
          color:
            mode: DISABLED
      dimensionsSecondGroup:
        - name: action_type
          value:
            mode: FORMULA
            formula: '"phases"."action_type"'
          dbDataType: String
          formatting:
            value: AUTO
            mode: BASE
          hideEmptyValues: false
          format:
            value: STRING
            mode: BASE
          onClick: []
          displayCondition:
            mode: DISABLED
          color:
            mode: DISABLED
      measures:
        - name: Amount
          value:
            mode: FORMULA
            formula: count()
          dbDataType: UInt64
          formatting:
            value: AUTO
            mode: BASE
          format:
            value: NUMBER
            mode: BASE
          showLabels:
            enabled: true
            size: 12
          color:
            mode: AUTO
          displayCondition:
            mode: DISABLED
      chartType: STACK
      orientation: AUTO
      legend:
        position: BOTTOM
        align: CENTER
        verticalAlign: TOP
        width:
          mode: PIXEL
          value: null
      filters: []
      barWidth: null