---
title: "Customizations"
slug: "customizations"
updated: 2025-10-16T09:05:56Z
published: 2025-10-16T09:05:56Z
---

> ## Documentation Index
> Fetch the complete documentation index at: https://traceabledocs.document360.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Customizations

The WAAP dashboards are shown in **View Mode** (![](https://cdn.document360.io/24f14f07-13d1-4684-8fae-6d8f811768ee/Images/Documentation/traceable_view_icon.png)) by default; however, you can add or customize widgets according to your requirements using **Edit Mode** (![](https://cdn.document360.io/24f14f07-13d1-4684-8fae-6d8f811768ee/Images/Documentation/traceable_edit_icon(1).png)).

## Widgets and their use in Dashboards

Widgets are the building blocks of the WAAP Dashboards in Traceable, allowing you to visualize important metrics in a way that best suits your needs. These widgets are made using charts and multiple other attributes. Traceable provides a variety of charts, such as Table, Bar, Donut, etc., to customize a widget, with each chart designed to represent data for simplifying analysis. By adding or customizing widgets, you can create a personalized dashboard that provides actionable insights at a glance.

## Supported Chart Types and Widget Anatomy

Traceable supports the following charts in dashboard widgets:

- Table
- Time Series
- Column
- Bar
- Donut
- Univariate

Each widget, along with the above supported charts, consists of a set of attributes that define how and what data should be shown in it. You can use these attributes and customize the dashboard according to your requirements. For more information, see the sections below. Apart from adding widgets, you can also carry out multiple actions in a dashboard. For more information, see Actions.

## Widget Builder Attributes

Traceable provides the following attributes for a widget:

| Attribute | Description |
| --- | --- |
| **Charts** | The different types of charts you wish to choose from to best visualize the data. For example, *Donut*. |
| **Chart Options** | The options to control what to show and how you wish to format the data. For example, *Show Legend*. > [!NOTE] > Note > > The availability of chart options depends on whether or not it is applicable in a widget. |
| **Datasource** | The data origin that Traceable must interact with to display data in the widget. For example, the threat-related security data (*Security Events*). > [!NOTE] > Note > > The availability of a datasource depends on whether or not it can be displayed in the widget. |
| **Selections** | The metric you wish to measure using the widget. This includes the primary data field you wish to analyze, along with how Traceable should process the data. For example, how many times a different security event occurred (*Count* of *Event ID*). Depending on the chart you select, you can choose multiple components to add to the widget. |
| **Filter** | The option to fine-tune and show only the relevant data in the chart, making it more actionable. This includes the component you wish to use for filtering data along with the required operator and value from the drop-down list. For example, show only security events from the MODSEC family (*Event Family* *IN MODSEC*). |
| **Group By** | The component you wish to use for grouping similar values, and the maximum number of groups you want to show on the chart. Depending on the widget you select, you can choose multiple components by which the results must be grouped in the chart. For example, group events by *CVE* as the *Threat Label*, with a maximum of *5* categories. |
| **Order By** | The component you wish to use for sorting the results, and its order in the chart, ASC for ascending and *DESC* for descending. For example, sort by *Event ID Count* in descending order (*DESC*). |
| **Limit** | This defines the maximum number of elements you want to show in the chart. For example, a limit of *10* for a table widget means that a maximum of 10 rows should be shown in the table at any point in time. |

While configuring a widget, you must specify or select the above attributes and their corresponding fields according to your requirements.

> [!NOTE]
> Note
> 
> The availability of certain attributes depends on the chart you select.

---

## Widget Configurations

The following tabs discuss the charts for configuring widgets, the attributes available in each widget, and a sample widget for reference.

TableTime SeriesColumnBarDonutUnivariate

The table widget organizes the data in the form of rows and columns. The cells in these rows and columns are populated with the appropriate values according to the attributes you select while adding them. The following table lists the availability of attributes and datasources for this widget:

| **Attributes** | - Datasource - Selections - Filters - Group By - Order By - Limit For more information on these attributes, see the above section. > [!NOTE] > Note > > Availability of the above attributes may depend on the datasource you select. |
| --- | --- |
| **Datasources** | - Actors - APIs - Security Events - Spans - Third-Party APIs - Traces - Vulnerabilities |

The time series widget organizes the data in the form of a graph. The graph is populated with the appropriate values for the past seven days according to the attributes you select while adding them. The following table lists the availability of attributes and datasources for this widget:

| **Attributes** | - Chart Options - Datasource - Selections - Filters - Group By For more information on these attributes, see the above section > [!NOTE] > Note > > Availability of the above attributes may depend on the datasource you select. |
| --- | --- |
| **Datasources** | - Custom Metric - Security Events - Spans - Threat Activity Distribution - Top Attribute Distribution (Security Events) - Traces - Traffic Distribution |

The column widget organizes the data in the form of rectangular columns. The columns populated in the widget represent the appropriate values according to the attributes you select while adding them. The following table lists the availability of attributes and datasources for this widget:

| **Attributes** | - Datasource - Selections - Filters - Group By - Order By - Limit For more information on these attributes, see the above section. > [!NOTE] > Note > > Availability of the above attributes may depend on the datasource you select. |
| --- | --- |
| **Datasources** | - API Entities by Endpoint Type - API Explore Count by Data Type - API Entities Count by Internal/External - APIs - Resolved Vulnerabilities - Security Events - Top 6 Threat Types - Top 6 Threat Types (v2) - Unresolved Vulnerabilities |

The bar widget organizes the data in the form of rectangular columns. The graph is populated with the bar height representing the appropriate values according to the attributes you select while adding them. The following table lists the availability of attributes and datasources for this widget:

| **Attributes** | - Datasource - Selections - Filters - Group By - Order By - Limit For more information on these attributes, see the above section > [!NOTE] > Note > > Availability of the above attributes may depend on the datasource you select. |
| --- | --- |
| **Datasources** | - API Entities by Endpoint Type - API Explore Count by Data Type - API Entities Count by Internal/External - APIs - Resolved Vulnerabilities - Security Events - Top 6 Threat Types - Top 6 Threat Types (v2) - Unresolved Vulnerabilities |

The donut widget organizes the data in the form of proportional segments. The size of these segments represents the proportional values according to the attributes you select while adding them. The following table lists the availability of attributes and datasources for this widget:

| **Attributes** | - Datasource - Filters - Group By - Limit For more information on these attributes, see the above section. > [!NOTE] > Note > > Availability of the above attributes may depend on the datasource you select. |
| --- | --- |
| **Datasources** | - API Entities by Endpoint Type - API Entities Count by Internal/External - APIs - Security Events |

The univariate widget displays data related to a single attribute. The attribute’s value depends on the attributes you select while adding them. The following table lists the availability of attributes and datasources for this widget:

| **Attributes** | - Datasource - Selections - Filters For more information on these attributes, see the above section > [!NOTE] > Note > > Availability of the above attributes may depend on the datasource you select. |
| --- | --- |
| **Datasources** | - Anomalous Spans - APIs - Custom Metric - Security Events - Spans - Text - Timestamp - Vulnerabilities |

#### Sample Widget

The following are the steps to add a sample donut widget that lists the top 5 threat types that Traceable has encountered from the MODSEC family, sorted in descending order:

![Sample Widget](https://cdn.document360.io/24f14f07-13d1-4684-8fae-6d8f811768ee/Images/Documentation/traceable_protection_waap_dashboard_sample_widget.png)

Sample Widget

1. In the**Widget Builder** window, under **Charts**, click *Donut*.
2. Select the **Chart Options** according to your requirements.
3. From the **Datasource** drop-down list, select your source of data. For example, *Security Events*.
4. From the **Selections** drop-down list, select the metric and the corresponding aggregation. For example, the *Count* (Aggregation) of *Event ID* (Selection).
5. Under **Filters**, click **+ Add Filter** and add one or more filters by selecting the component, operator, and value from the drop-down list for each. These components filter the data based on the attributes you select. For example, *Event Family* is ( IN ) *MODSEC*.
6. Under **Group By**, select the component to group the data by, and the maximum number of groups to display in the widget. For example, a maximum of *5* (Limit) *Threat Types* (Group By Component).
7. Under **Order By**, select the component you wish to use for sorting the results. For example, in *DESC* order using *Count* of *Event ID*.
8. Specify the **Limit**.
9. Click **Apply**. The widget preview is available in the right pane. You can modify it again according to your requirements using the above settings.
10. (Optional) Modify the name and description of the widget in the **Widget Preview** pane according to your requirements.
11. Click **Save**. The widget is added to the bottom of the dashboard.