Widget Display Settings

The Display tab controls the visual appearance of a widget.

The list below includes core settings, though additional options may be available depending on the widget type:

• Size
• Paddings
• Title and text
• Data presentation settings
• Axes and reference lines
• Data display limits and behavior

Widget Size

Widget size is defined by height and width.

Height can be specified either in pixels or as a percentage of the screen height where the dashboard is displayed:

• px — fixed height in pixels
• % — height calculated dynamically relative to screen height

Width can be specified either in pixels or as a fraction of the view width:

• px — fixed width in pixels
• fr — width defined as a portion of the total screen width

Paddings

This setting defines the spacing between the widget’s edges and its internal content.

Larger horizontal paddings reduce the available space for content. For example, increasing paddings on a bar chart shifts internal elements (titles, bars, etc.) similarly to resizing the widget itself. Vertical padding changes do not affect content height.

By default, the minimum padding is 8 pixels. To apply equal paddings on all sides, enter a single value. For different paddings per side (e.g., 10px top/bottom, 20px left/right, 5px bottom), specify values separated by commas: 10, 20, 5.

Title and Text

This group includes settings for customizing widget titles and the size of descriptions or internal text.

For the widget title, you can configure:

• Title size
• Title color (Auto or Basic modes)
• Title weight (regular or bold)

The Text size parameter sets the font size for all widget labels: legend, axis labels (X and Y), table text, etc.

Description Text

This setting is available only if the Description toggle is enabled in the data settings tab. It controls the Markdown description font size. Changes are visible in both edit mode and the advanced Markdown editor.

Changing the description text size affects all Markdown elements (e.g., headings, lists, quotes). Heading sizes scale proportionally based on the base description size.

Example: If the description size is set to 14, heading sizes are calculated as follows:

• Level 1: 38
• Level 2: 30
• Level 3: 24
• Level 4: 20
• Level 5: 16

If the description size increases to 25 (a difference of +11), heading sizes become:

• Level 1: 38 + 11 = 49
• Level 2: 30 + 11 = 41, etc.

If the new size is smaller (e.g., 10, a difference of –4), heading sizes decrease accordingly:

• Level 1: 38 – 4 = 34
• Level 2: 30 – 4 = 26, etc.

Data Presentation Settings

These settings apply to widgets with graphical data representation (charts, graphs, histograms) and allow customization of visualization style, legend, axes, and reference lines.

Display Type and Orientation

For Histogram, Donut Chart, Combined Bar Chart, Line Graph, and Bar Chart, users can select a chart type from the available options.

For Histogram, Combined Bar Chart, and Bar Chart, orientation can also be set to Bottom, Left, or Right. The Auto option is additionally available for histograms and bar charts.

Legend

For charts and line graphs, you can enable a legend that displays symbolic labels with explanations. Available positions:

• Disabled
• Left
• Top
• Bottom (default)
• Right

Legend alignment options:

• Left
• Center (default)
• Right

You can also set legend width as either a fixed pixel value or a percentage of the widget width.

Axes and Reference Lines

Charts and graphs support axis and reference line settings to control data display and visual perception.

X and Y axes can be toggled on/off. When enabled, related configuration options become available.

Reference lines serve as visual guides for comparing values, highlighting thresholds, or indicating targets.

X-Axis Settings

Control label and title display on the horizontal axis.

Available parameters:

• Label rotation: Sets the angle of X-axis labels (–90° to 90°)
• Label height: Defines the maximum pixel height for X-axis label area
• X-axis title: Toggle to show/hide the X-axis title (if defined)

Y-Axis Settings

Control label, title, and value range display on the vertical axis.

Available parameters:

• Label width: Sets the width of the Y-axis label area
• Y-axis title: Toggle to show/hide the Y-axis title (if defined)
• Range: Manually define min/max Y-axis values to refine scale and highlight subtle differences in narrow data ranges

Reference Lines

A reference line is a visual guide overlaid on a chart. It can be used to compare actual data against targets or benchmarks. Supported in Bar Chart, Combined Bar Chart, and Line Graph.

To add a reference line, enable the Reference lines toggle in display settings and click + Line.

Reference line settings:

• Name (default: Reference line)
• Formula
• Color (basic colors supported)
• Line style: solid or dashed (for dashed lines, dash length can be adjusted—higher values produce fewer dashes)
• Thickness

Formula values can be positive or negative. The chart automatically rescales to accommodate the reference line value.

Reference lines appear above bars and other chart elements. In view mode, hovering over a reference line shows a tooltip with its name and current value.

Data Display Limits and Behavior

These settings control data volume and presentation nuances. Available options depend on widget type and data structure.

Display Limits

Limits help simplify data perception by restricting visible elements.

• Dimension limit: Restricts the number of dimension values shown (available for charts/graphs with dimensions)
• Second dimension limit: Available for Bar Chart and Line Graph when two dimensions are used
• Row limit: For Table and Pivot Table, limits rows per page
• Column limit: For pivot tables only, restricts visible columns
• Dimension limit: Also used in Strip Chart to limit displayed items

Empty Values and Tooltips

Additional behavioral settings for some widgets:

• Hide empty values: Excludes elements where the value is:
  • An empty string (text)
  • Zero (numeric)
  • Unix epoch date (1970-01-01 00:00:00) for Date types
  • Null
• Tooltip: Enables/disables hover tooltips on widget elements

Additional Widget-Specific Settings

Depending on the widget type, extra settings outside the standard groups may be available. Examples include:

• Table header background color
• Processes sphere metric sizing
• Current date line in strip charts

A complete list of widget-specific settings is provided in the documentation for each widget type.