---
url: /reference/ui/dashboard/widgets.md
---
# Widgets

Teamscale offers a large variety of highly configurable widgets to
create personalized dashboards. These widgets and their configuration
options are displayed in the following. Some options are the same for
all widgets. Thus, they are described only once at the beginning.

## Common Widget Configuration Options

The following table denotes configuration options that are commonly shared by many widgets.
As an example, this image shows the beginning of a configuration dialog containing some of these options:

![Excerpt of Widget Configuration Dialog](../dashboard-widget-config.png)

## Assessment Pie Chart Widget

![Assessment Pie Chart Widget](./assessment-pie-chart.png)

## Assessment Trend Chart Widget

![Assessment Trend Chart Widget](./assessment-trend-chart.png)

## Code City Widget

![Code City Widget](./code-city.png)

## Commit Chart Widget

![Commit Chart Widget](./commit-chart.png)

## External Content Widget

![External Content](./external-content.png)

:::warning
When the external content needs to work with cookies, e.g. for login state, the external site must be using HTTPS and have its cookies use the `Secure;SameSite=None` attributes to make modern browsers send the cookies.
:::

## Findings Churn Widget

![Findings Churn Widget](./findings-churn.png)

## Findings Summary Bar Chart Widget

![Findings Summary Bar Chart Widget](./findings-summary-bar-chart.png)

## Findings Summary Table Widget

![Findings Summary Table Widget](./findings-summary-table.png)

## Issue Table Widget

![Issue Table Widget](./issue-table.png)

## Label Widget

![Label Widget](./label.png)

## Metric Bar Chart Widget

![Displaying multiple metrics.](./metric-bar-chart.png)

![Comparing lines of code.](./metric-bar-chart-example.png)

## Metrics Change Table Widget

![Metrics Change Table Widget](./metric-change-table.png)

## Metric Distribution Pie Chart Widget

![Metric Distribution Pie Chart Widget](./metric-distribution-pie-chart.png)

## Metric Distribution Table Widget

![Metric Distribution Table Widget](./metric-distribution-table.png)

## Metric File Distribution Widget

![Metric File Distribution Widget](./metric-file-distribution.png)

## Metrics Hotspot Table Widget

![Metrics Hotspot Table Widget](./metric-hotspot-table.png)

## Metrics Table Widget

![Metrics Table Widget](./metrics-table.png)

## Metrics Trend Chart Widget

![Metric Trend Chart Widget](./metrics-trend-chart.png)
![Metric Trend Chart Widget With Thresholds](./trend-with-thresholds.png)

## Numeric Metric Value Widget

![Numeric Metric Value Widget](./numeric-metric-value.png)

## Ownership Treemap Widget

![Ownership Treemap Widget](./ownership-treemap.png)

## Single Metric Trend Widget

![Single Metric Trend Widget](./single-metric-trend2.png)

## Test Gap Overview Widget

![Test Gap Overview Widget](./test-gap-overview.png)

## Test Gap Pie Chart Widget

![Test Gap Pie Chart Widget](./test-gap-pie-chart.png)

## Test Gap Treemap Widget

![Test Gap Treemap Widget](./test-gap-treemap.png)

## Test Gap Trend Chart Widget

![Complete trend.](./test-gap-trend-chart.png)

![Only percent trend.](./test-gap-trend-chart2.png)

## Treemap Widget

![Treemap Widget](./treemap.png)

## Issue-based Metric Treemap Widget

![Issue-based Metric Treemap Widget](./issue-based-metric-treemap-widget.png)

## Method-based Treemap Widget

![Method-based Treemap Widget](./method-based-treemap-widget.png)

## Metrics Scatter Plot Widget

![Metrics Scatter Plot Widget](./metrics-scatter-plot.png)

## Task Summary Pie Chart Widget

![Task Summary Pie Chart Widget](./task-summary-pie-chart.png)