Skip to main content
Matrix42 Self-Service Help Center

Widgets: Standard Widgets Library & Configuration

Overview

Widgets are reusable visual components designed to display data or other content in an interactive and easily digestible format. Standard widgets are not only used in the Service Catalog Dashboard and Service Desk Dashboard, but also allow adjusting and customizing existing dashboards, extending them, or creating new ones.

This page provides a detailed description and configuration of standard widget visualization types in the application.

To add and configure a new widget to show your data on the Dashboard, see Managing Dashboards in New Look page.

Chart Types and Configuration Properties

For convenience, charts are divided into categories and each category includes the following charts and configurable properties:

Category

Chart Name

Title/ Record Type / Filters

Drill down 

(Data List)

Timeline Configuration

Configure Axis Title

Conditional Coloring

Show legend

Show Total

Interactive Filters

Comparison

 

Bar Chart

✖️

✖️

✖️

Column Chart

✖️

✖️

✖️

Proportion

 

Pie Chart

✖️

✖️

✖️

✖️

Donut Chart

✖️

✖️

✖️

Card

 

Percentage Card

✖️

✖️

✖️

✖️

Metric Card

✖️

✖️

✖️

✖️

Composition

 

 

Combo Chart

✖️

✖️

✖️

✖️

Stacked Bar Chart

✖️

✖️

Stacked Column Chart

✖️

✖️

Distribution

 

 

Percentage by Category

✅ 

✅ 

✖️

✖️

✖️

✖️

✖️

✅ 

Area Chart

✅ 

✅ 

✅ 

✅ 

✖️

✅ 

✖️

✅ 

Line Chart

✅ 

✅ 

✅ 

✅ 

✖️

✅ 

✖️

✅ 

Miscellaneous category is not included in the table as its charts have little in common and each is described in detail below

Comparison

These charts are used to compare different categories or groups. They help identify differences, similarities, and trends among various data sets.

Bar Chart

Bar Chart displays categorical data with horizontal bars where the length of each bar represents the value.
Bar Chart example.png

Column Chart

Column Chart is similar to a bar chart but with vertical bars.
Column Chart example.png

Configuration

Bar Chart and Column Chart include the same set of configurable properties, the only difference is how the data is displayed on the Widget. 

Data Source

To define the data source, fill out the following fields:

  • Title: provide the title that will be displayed on the Widget and as the Widget name in the Dashboard Configuration panel.
  • Record Type (mandatory): select from the list of the available in the system Configuration Items.
  • Filters: optionally, apply the necessary filters to consider only those records that fall under the filtering conditions. Only those records that meet all specified conditions will be shown in the results.  You can choose from the list of filers that are available for the selected Dataset (see Advanced mode configuration).
  • Advanced Mode: click on the toggle button to switch on the advanced properties configuration
    • Dataset (mandatory):  the Data Query for the selected Record Type. It is set automatically when the Record Type is set and if the Data Query for the set Record Type exists.
      • Grouping Column: Select by which column to group the data in the widget (e.g., Priority, Status). A list of available columns is suggested from the selected Dataset.
    • Data List: optional property that is used to drill down the data. It is set automatically if the Record Type is set and Dataset View exists. Choose the Dataset View that should be opened when you click on the Widget title and you'll see a Dataset View with the details on the data records.
Data displaying

Depending on the selected data source, you can configure data displaying on the Widget as a timeline or as top records:

  1. Configure Timeline: if the defined in the data source data can be organized in chronological sequence,  select the checkbox to enable the timeline configuration and set Step and Rolling Period 
    • Step: choose from the suggested options (1 hour / 1 day / 1 month / 1 year)
    • Rolling Period: choose from the suggested options (Last 7 days / Last 2 weeks / Last 4 weeks / Last 12 weeks / Last year)
      Configure Timeline.png
      Timeline configuration example
  2. Top records: enable the Advanced Mode and fill out the following fields
    1. Top: set a number to limit how many records with the highest values should be shown on the widget
      top_10_grouping_column1.png
      Top 10  Backlog Activities grouped by Responsible Role example
    2. Aggregation Type: choose how the values will be aggregated across your Dataset. Possible values:
      1. Count (default): counts the number of records in the dataset
      2. Sum: adds up the values in a numeric column
      3. Max: shows the highest values of a dataset
      4. Min: finds the lowest value in a dataset
      5. Average: calculates the arithmetic mean of values in a dataset. Average= sum of values/ count of values
        For all other aggregation types, except the default Count, choose the Column for Aggregation:
        Columns for aggregation.png
        Column for Aggregation suggests suitable columns with numeric data type from the selected Dataset (Data Query).
    3. Configure Axis Title: select the checkbox to enable the configuration and set Titles for X and Y Axis:
      1. X-Axis Title: set the title for the horizontally displayed values
      2. Y-Axis Title: set the title for the vertically displayed values
        Configure Axis Title example1.png
        Configure Axis Title example

Proportion

These charts display the parts of a whole, illustrating how individual components contribute to the total.

Pie Chart

Pie Chart is a circular chart divided into slices to represent the proportions of a whole.
Pie Chart example.png

Donut Chart

Donut Chart is a variation of the pie chart with a hole in the center. Used to display proportional data, with the central space showing additional information, e.g. total number of items in the chart.
Donut Chart example.png

Configuration

Pie Chart and Donut Chart include the same set of configurable properties, the only difference is how the data is displayed on the Widget and that the Donut Chart can show the total in the middle of the chart. 

  • Title: provide the title that will be displayed on the Widget and as the Widget name in the Dashboard Configuration panel.
  • Record Type (mandatory): select from the list of the available in the system Configuration Items.
  • Filters: optionally, apply the necessary filters to consider only those records that fall under the filtering conditions. Only those records that meet all specified conditions will be shown in the results. You can choose from the list of filers that are available for the selected Dataset (see Advanced mode configuration).
  • Grouping Column: Select by which column to group the data in the widget (e.g., Priority, Status).
  • Show Legend: disabled by default. Select the checkbox to see the legend based on the selected Grouping Column;
  • Show Total (Pie Chart only): disabled by default. Select the checkbox to see the total number of items retrieved to this widget in the middle of the chart;
    edit pie chart1.png
  • Advanced Mode: click on the toggle button to switch on the advanced properties configuration
    • Dataset (mandatory):  the Data Query for the selected Record Type. It is set automatically when the Record Type is set and if the Data Query for the set Record Type exists;
    • Data List: optional property that is used to drill down the data. It is set automatically if the Record Type is set and Dataset View exists. Choose the Dataset View that should be opened when you click on the Widget title and you'll see a Dataset View with the details on the data records;
    • Top: set a number to limit how many records with the highest values should be shown on the widget and retrieved to the legend (if enabled);
    • Aggregation Type: choose how the values will be aggregated across your Dataset. Possible values:
      1. Count (default)
      2. Sum 
      3. Max
      4. Min
      5. Average
        For all other aggregation types, except the default Count, choose the Column for Aggregation:
        Columns for aggregation.png
        Column for Aggregation suggests suitable columns with numeric data type from the selected Dataset (Data Query).

Card

Cards display key metrics and KPIs in a concise, easily digestible format, providing at-a-glance insights.

Percentage Card

The widget displays a percentage value in a widget layout:
Percentage card example.png

Configuration: includes 2 sections, Comparison and Base. Base is taken as the 100% and the Comparison shows the percentage on the Widget relatively to the Base value. Configure the set of the following fields for both Comparison and Base sections:

  • Title: provide the title that will be displayed on the Widget and as the Widget name in the Dashboard Configuration panel.
  • Record Type (mandatory): select from the list of the available in the system Configuration Items.
  • Filters: optionally, apply the necessary filters to consider only those records that fall under the filtering conditions. Only those records that meet all specified conditions will be shown in the results.  You can choose from the list of filers that are available for the selected Dataset (see Advanced mode configuration).
  • Advanced Mode: click on the toggle button to switch on the advanced properties configuration
    • Dataset (mandatory):  the Data Query for the selected Record Type. It is set automatically when the Record Type is set and if the Data Query for the set Record Type exists.
    • Data List: optional property that is used to drill down the data. It is set automatically if the Record Type is set and Dataset View exists. Choose the Dataset View that should be opened when you click on the Widget title and you'll see a Dataset View with the details on the data records.
    • Aggregation Type: Choose how the values will be aggregated across your dataset. Possible values:
      • Count (default)
      • Sum 
      • Max
      • Min
      • Average
        For all other aggregation types, except the default Count, choose the Column for Aggregation:
        Columns for aggregation.png
        Column for Aggregation suggests suitable columns with numeric data type from the selected Dataset (Data Query).

Additionally, you can configure the Conditional Coloring for the Widget.

Metric Card

Highlights a key number or metric within a widget layout. Used for KPIs, such as the total number of incidents within some period, the number of placed orders, etc.:
Metric card example.png

Configuration:

  • Record Type (mandatory): select from the list of the available in the system Configuration Items.
  • Filters: optionally, apply the necessary filters to take into account only those records that fall under the filtering conditions. Only those records that meet all specified conditions will be shown in the results. You can choose from the list of filers that are available for the selected Dataset (see Advanced mode configuration). 
  • Advanced Mode: click on the toggle button to switch on the advanced properties configuration
    • Dataset (mandatory):  the Data Query for the selected Record Type. It is set automatically when the Record Type is set and if the Data Query for the set Record Type exists.
    • Data List: optional property that is used to drill down the data. It is set automatically if the Record Type is set and Dataset View exists. Choose the Dataset View that should be opened when you click on the Widget title and you'll see a Dataset View with the details on the data records.
    • Aggregation Type: Choose how the values will be aggregated across your dataset. Possible values:
      • Count (default)
      • Sum 
      • Max
      • Min
      • Average
        For all other aggregation types, except the default Count, choose the Column for Aggregation:
        Columns for aggregation.png
        Column for Aggregation suggests suitable columns with numeric data type from the selected Dataset (Data Query).

Additionally, you can configure the Conditional Coloring for the Widget.

Conditional Coloring

This property allows highlighting certain values or making them more prominent. 

Widget conditional formatting.png

The added rule changes the displayed value color based on a specified condition. To add a rule,

  • Scroll to the bottom of the Widget configuration
  • Click + Add Rule
  • Specify the Conditional Coloring rule:
    • Color: Choose a color or enter a color code in HEX format
    • Operator: Choose from the suggested operators and set against which value the rule will be checked and applied. Operators:
      • < (default) less than
      • > more than
      • <= less than or equals
      • >= more than or equals
      • <> not equal to
      • = equals to

You can manage the Conditional Coloring by adding as many rules as necessary or deleting them anytime.

Composition

These charts illustrate the data composition, showing how different parts make up a whole and how they change over time. 

Combo Chart

Combo Chart is a chart that combines two or more chart types (e.g., column and line charts) to show different data sets on the same axis. Useful for comparing multiple data trends over the same period.
Combo chart example.png

Stacked Bar Chart

Stacked Bar Chart is a bar chart where each bar is divided into segments representing different sub-categories, stacked on top of each other. Shows the composition of different groups within a total.
Stacked Bar Chart example.png

Stacked Column Chart

Stacked Column Chart is similar to a Stacked Bar Chart but with vertical columns. Useful to show the contribution of parts to the whole over multiple periods.
Stacked Column Chart example.png

Configuration 

Stacked Bar Chart and Stacked Column Chart include the same set of configurable properties, the only difference is how the data is displayed on the Widget. 

  • Record Type: (mandatory): select from the list of the available in the system Configuration Items.
  • Filters: optionally, apply the necessary filters to consider only those records that fall under the filtering conditions. Only those records that meet all specified conditions will be shown in the results. You can choose from the list of filers that are available for the selected Dataset (see Advanced mode configuration). 
  • Grouping Column: select by which column to group the data in the widget (e.g., Submitted on, Created date, etc.).
  • Series Column: defines which data should be represented in the chart, each segment of a bar/column represents each of the series
  • Configure Timeline: if the defined in the data source data can be organized in chronological sequence,  select the checkbox to enable the timeline configuration and set Step and Rolling Period 
    • Step: choose from the suggested options (1 hour / 1 day / 1 month / 1 year)
    • Rolling Period: choose from the suggested options (Last 7 days / Last 2 weeks / Last 4 weeks / Last 12 weeks / Last year)
  • Show Legend: disabled by default. Select the checkbox to see the legend for the shown on the chart items, otherwise, it will be visible only if you hover over the chart data segments
    stacked bar chart configuration1.png
    Stacked Bar Chart configuration example.
  • Advanced Mode: click on the toggle button to switch on the advanced properties configuration
    • Dataset (mandatory):  the Data Query for the selected Record Type. It is set automatically when the Record Type is set and if the Data Query for the set Record Type exists.
    • Data List: optional property that is used to drill down the data. It is set automatically if the Record Type is set and Dataset View exists. Choose the Dataset View that should be opened when you click on the Widget title and you'll see a Dataset View with the details on the data records.
    • Top: set a number to limit how many records with the highest values should be shown on the widget and retrieved to the legend (if enabled);
    • Aggregation Type: Choose how the values will be aggregated across your dataset. Possible values:
      • Count (default)
      • Sum 
      • Max
      • Min
      • Average
        For all other aggregation types, except the default Count, choose the Column for Aggregation:
        Columns for aggregation.png
        Column for Aggregation suggests suitable columns with numeric data type from the selected Dataset (Data Query).
    • Configure Axis Title: select the checkbox to enable the configuration and set Titles for X and Y Axis:
      1. X-Axis Title: set the title for the horizontally displayed values
      2. Y-Axis Title: set the title for the vertically displayed values

Distribution

These charts display the distribution and spread of data, showing the range, outliers, and patterns within datasets.

Percentage by Category

  • Percentage by Category: displays the percentage of a total for different categories. Useful when comparing proportions across multiple groups.
    Percentage by Category example.png

Area Chart

Area Chart is a line chart where the area under the line is filled with color to represent volume. Ideal for showing cumulative trends over time:

Area Chart example.png

Line Chart

Line Chart uses points connected by lines to show trends over time:

Line chart example.png

Area & Line Charts Configuration

Area Chart and Line Chart include the same set of configurable properties, the only difference is how the data is displayed on the Widget.

  • Record Type: (mandatory): select from the list of the available in the system Configuration Items.
  • Filters: optionally, apply the necessary filters to consider only those records that fall under the filtering conditions. Only those records that meet all specified conditions will be shown in the results. You can choose from the list of filers that are available for the selected Dataset (see Advanced mode configuration). 
  • Grouping Column: select by which column to group the data in the widget (e.g., Submitted on, Created date, etc.).
  • Series Column: defines which data should be represented in the chart, each line/area represents each of the series
  • Configure Timeline: if the defined in the data source data can be organized in chronological sequence,  select the checkbox to enable the timeline configuration and set Step and Rolling Period 
    • Step: choose from the suggested options (1 hour / 1 day / 1 month / 1 year)
    • Rolling Period: choose from the suggested options (Last 7 days / Last 2 weeks / Last 4 weeks / Last 12 weeks / Last year)
  • Show Legend: disabled by default. Select the checkbox to see the legend for the shown on the chart items, otherwise, it will be visible only if you hover over the chart data items.
  • Advanced Mode: click on the toggle button to switch on the advanced properties configuration
    • Dataset (mandatory):  the Data Query for the selected Record Type. It is set automatically when the Record Type is set and if the Data Query for the set Record Type exists.
    • Data List: optional property that is used to drill down the data. It is set automatically if the Record Type is set and Dataset View exists. Choose the Dataset View that should be opened when you click on the Widget title and you'll see a Dataset View with the details on the data records.
    • Top: set a number to limit how many records with the highest values should be shown on the widget and retrieved to the legend (if enabled);
    • Aggregation Type: Choose how the values will be aggregated across your dataset. Possible values:
      • Count (default)
      • Sum 
      • Max
      • Min
      • Average
        For all other aggregation types, except the default Count, choose the Column for Aggregation:
        Columns for aggregation.png
        Column for Aggregation suggests suitable columns with numeric data type from the selected Dataset (Data Query).
    • Configure Axis Title: select the checkbox to enable the configuration and set Titles for X and Y Axis:
      1. X-Axis Title: set the title for the horizontally displayed values
      2. Y-Axis Title: set the title for the vertically displayed values
        area chart axis title.png
        Area Chart: Axis Title configuration example

Miscellaneous

These widgets offer additional functionalities and display options that don't fit into the other categories.

Embedded Web Page

The widget shows a live webpage integrated into a dashboard widget:
Embedded Web Page example.png

Configuration: 

  • Title: provide a title that will be shown on the widget
  • Widget type: choose Embedded Web Page
  • External URL: enter the complete URL address to the page you want to display starting with https://

The embedded page is interactive, you can scroll through it or, for instance, if it's a link to the video you can play it directly from the widget.

Quick Link Panel

A panel where you can configure links for quick access to other navigation items, actions of the current application, or access to specified external links.
Quick Link Panel example.png

Configuration:

  • Title: provide a title that will be shown on the widget
  • Widget type: choose Quick Link Panel
  • Configure suggested options:
    • Label: textual element or a name of the added quick link
    • Icon: visual element used for the quick link. Choose an icon from the suggested library 
    • Type
      • Go to Navigation Item: specify the Navigation Item suggested from the list and optionally apply Filter to choose from which Data Query the data should be displayed.
      • Open Dialog: specify the Entity Type from the suggested list to open the necessary Dialog Layout.
      • Run Action: choose the Action that this quick link should run.
      • Show DatasetSelect the Dataset View available in the system and optionally apply a Filter to select which Data Query the data should be displayed from.
      • Open External URL: specify the URL that should be opened.
    • Remove This Link: deletes the link from the widget.
  • Add New Link: add and configure as many Quick Links as necessary

Quick Link Panel configuration.png

Rich Text

Text with formatting options such as bold, italic, links, and images.
Rich text example.png

Configuration: 

  • Title: provide a title that will be shown on the widget
  • Widget type: choose Rich Text
  • Text: edit content in the Text area. Adjust the font size, color, create lists, tables, add media, links, change the content alignment, inline style (bold, italic, underline, strikethrough, superscript, subscript, code), add headings or blocks.

Rich text widget configuration.png

Announcements

Shows a carousel with all available in the system announcements:
announcements widget example.png

Configuration: 

  • Title: provide a title that will be shown on the widget
  • Widget type: choose Announcements type. All the Announcements from the system will be shown in this widget.

add new widget Announcement1.png

  • Was this article helpful?