Widgets

Widgets are the building blocks of every dashboard. Each widget occupies a rectangular area on the grid and displays a specific type of data or content - from simple values and status indicators to rich charts and tables. The Dashboard application comes with a versatile set of built-in system widgets, and additional widget types may be available depending on the product and installed plugins.

A widget is added to the dashboard as follows:

1. Enter edit mode by clicking the Edit Widgets pencil icon.
2. Click on an empty cell or draw a rectangular area across multiple cells where the widget should appear.
3. The New Widget dialog opens, displaying all available widget types organized by category.
4. The Filter for widgets search field at the top can be used to quickly find a specific widget type.
5. Click on the desired widget to add it to the selected area.

If a widget has previously been copied to the clipboard, a paste option is also available, allowing a widget to be duplicated with all its settings in just one click.

Each widget has a settings dialog that can be opened by clicking the pencil icon on the widget in edit mode. The available settings vary by widget type, but a number of common settings apply across many widgets.

An optional custom title for the widget. If left empty, no title is displayed.

Many widgets support multiple visualization types, so you can choose the option that best fits the use case.

The available options depend on the widget and may include:

• Value - Displays a single large text value, perfect for highlighting one key number.
• Gauge - A semi-circular gauge meter showing a value relative to a configurable maximum.
• Progress - A horizontal progress bar for quick visual comparison.
• Traffic Light - A color-coded traffic light indicator with red, yellow, and green states.
• Rating - A star rating display.
• Pie Chart - A pie chart for proportional data.
• Doughnut Chart - A ring-shaped variant of the pie chart.
• Bar Chart - A bar chart for categorical comparisons.
• Line Chart - A line chart for time series or trend data.
• Table - A tabular data display with rows and columns.

When a chart visualization is selected, the following additional settings become available:

• Axis Orientation - Controls the axis direction. The following values are available:
  • Bottom, Left, Top, Right
• Legend Position - Controls where the chart legend is displayed. The following values are available:
  • None, Top, Bottom, Left, Right
• Display all labels on the X-axis and rotate them by 45 degrees - Useful for charts with many categories to prevent label overlap.
• Show Also as Percentage Value - Displays percentage values alongside absolute values in pie and doughnut charts.
• Swap Columns and Rows - Transposes table data.
• Display Values in Cells - Shows numeric values for the Heatmap visualization directly within chart cells.

For charts, a fully customizable color palette is available. Each color in the set can be individually edited using hex color codes, and colors can be reordered using the up/down arrows or removed using the delete button. More colors can be added with the Add color button.

Color presets make it easy to maintain a consistent look across widgets:

• Open presets - Browse and apply previously saved color schemes.
• Save preset - Save the current color set as a named preset for reuse across widgets.

Color presets are stored for the signed-in user. They are personal to your profile and are not shared with other user accounts.

These settings control how labels and additional text are shown below the widget value:

• Label - A custom label shown below the value (at the bottom of the widget).
• Show label below value - Toggles the visibility of the label.

Highlights allow conditional formatting of widget values, so that important changes are visible at a glance. Each highlight rule consists of:

• Condition - The comparison operator. The following conditions are available:
  • Equals, Greater than, Greater or equals, Lesser than, Less or equals
  • Length equals, Length greater than, Length greater or equals, Length lesser than, Length less or equals
• Value - The threshold value to check against.
• Foreground - An optional custom text color when the condition is met.
• Background - An optional custom background color when the condition is met.

For the Length ... conditions, the comparison uses the number of characters in the widget's displayed value as text. Those operators appear when the highlight uses a plain text value. When the value uses units with numeric input, only the numeric comparisons in the first row are available.

Multiple highlight rules can be added and reordered using the Move Up and Move Down buttons. A live preview shows how the highlight will appear, so colors can be fine-tuned before saving.

These settings apply to the Gauge and Progress visualizations:

• Maximum Value - The upper bound for Gauge and Progress visualizations.
• Substeps - The number of intermediate tick marks on a Gauge.
• Percentage Display - Shows values as percentages instead of absolute numbers for the Gauge visualization.

When a widget uses the Traffic Light visualization, the thresholds that determine the color can be configured:

• Green Limit - Values below this threshold are shown in green.
• Red Limit - Values above this threshold are shown in red.
• Values between the two limits are shown in yellow.
• Swap Limits - Reverses the color logic, e.g., high values become green instead of red.

Apply saves your changes but keeps the dialog open so you can continue adjusting settings. Save saves and closes the dialog. Cancel closes without keeping changes you have not saved.

The list below is a selection; depending on the product, more system widgets may be present, and additional ones may be added in the future.

The following widget types are available in the System category. These are built-in widgets that ship with the Dashboard application.

Displays the number of currently active users on the server. This widget requires user management permissions.

• Group - Filter by a specific user group.
  • Default value: All Users
• Visualization - Value, Gauge, Progress, Traffic Light, or Rating.

Displays the remaining validity of a TLS certificate in days. This is a convenient way to keep track of certificate renewals and avoid unexpected expiration.

• Endpoint - The HTTPS URL with port or a host:port pair for any TLS service, such as https://example.com:443 or mail.example.com:993.

Shows the current system CPU utilization as a percentage. The value updates in real time, giving an immediate overview of the server load.

• Visualization - Value, Gauge, Progress, Traffic Light, or Rating.

Displays the amount of used storage space relative to the total available storage for a configurable partition. This widget requires the Server Administration permission.

• Root - A file system partition to display the usage of. This can be a volume or, e.g. a user home directory.
• Visualization - Value, Gauge, Progress, Traffic Light, Rating, Pie Chart, Doughnut Chart, Bar Chart, or Table. The widget displays a breakdown of used vs. free space.

Displays recent errors for the selected time range. A quick and easy way to check system health without leaving the dashboard.

Checks an HTTP or HTTPS URL hourly and visualizes the result as a traffic light. Green indicates a successful response, yellow indicates a warning, and red indicates a failure or unreachable URL. This widget requires the Configuration permission.

• URL - The HTTP or HTTPS URL to monitor, such as https://example.com/health.

Displays an image loaded from a URL. Supports HTTP, HTTPS, and Base64 data URLs. The image can be refreshed at configurable intervals, which is useful for displaying live camera feeds, status badges, or dynamically generated graphics.

• Image URL - The URL of the image to display. A Base64 data URL is also supported.
• Update Interval - How often the image is refreshed. The following values are available:
  • Never, 1 Minute, 10 Minutes, 30 Minutes, 1 Hour, 2 Hours, 1 Day
• Scale - How the image is fitted within the widget area. The following values are available:
  • Original Size - The image is displayed at its native size. Borders appear if the image is smaller than the widget, and the image is cropped if larger.
  • Stretch - The image is stretched to fill the entire widget area. Distortion may occur.
  • Contain - The image is scaled to be fully visible within the widget, maintaining its aspect ratio. Borders may appear.
  • Cover - The image is scaled to cover the entire widget area, maintaining its aspect ratio. Parts of the image may be cropped.

Displays a custom text memo with Markdown formatting support. Suitable for notes, reminders, team announcements, or any freeform text to keep visible on the dashboard.

• Memo - The memo text content. Markdown formatting is supported for headings, bold, italic, lists, links, and other formatting.
• Text Color - A custom color for the memo text.
• Background Color - A custom background color for the memo widget.
• Text style - The text formatting style. The following values are available:
  • Normal, Bold, Italic, Bold & Italic
• Memo Widget Design - The visual design of the memo widget. The following values are available:
  • Plain - A simple, borderless memo.
  • Index Card - Styled to look like a physical index card.
  • Ring Binder - Styled to resemble a page from a ring binder.

Shows the current system RAM utilization as a percentage. The value updates in real time, helping to keep track of memory consumption.

• Visualization - Value, Gauge, Progress, Traffic Light, or Rating.

Displays the CPU load of individual threads over the last 60 seconds. This widget provides a detailed breakdown of thread-level CPU consumption, useful for diagnosing performance bottlenecks.

• Number of threads to display - Limits how many threads are shown.
  • Default value: 10
• Visualization - Line Chart. The chart shows each thread as a separate colored line.
• Axis Orientation - Bottom, Left, Top, or Right.
• Legend Position - Where the legend listing thread names is displayed.
• Color Set - Fully customizable color palette for the thread lines.

Displays the current date and/or time for a selected time zone. Handy when working with teams or services across different time zones.

• Time Zone - The time zone to use for the display.
• Format - Choose between time-only, date-only, or combined date and time formats.

A static traffic light widget with a manually selectable color and optional text messages. Unlike the HTTP Check widget which sets its color automatically based on a URL check, this widget displays a fixed chosen color - useful for manual status indicators or announcements.

• Traffic Light Color - Red, Yellow, Green, or Off.
• Note Text - Optional text displayed alongside the traffic light.
• Additive texts - Additional text messages that appear when a specific color is active:
  • Additive for "Green" Color
  • Additive for "Yellow" Color
  • Additive for "Red" Color
  • Addition for "Off" state

Depending on the product and installed plugins, additional widget categories and types may be available beyond the system widgets listed above. For example, a help desk product might provide ticket statistics widgets, chart widgets for tracking ticket trends, or milestone overview widgets. These product-specific widgets follow the same principles for placement, configuration, and visualization as the system widgets.