Widgets & Plugins
Widgets are the tiles that make up a dashboard. There are two kinds:
- Built-in widgets — charts, tables, and metrics configured from a form.
- Plugins — installed apps that appear as their own tiles. An administrator installs them once (see Managing plugins); developers build them with the Plugin SDK.
Adding a widget
- Open a dashboard and click Edit (Save and Cancel replace it while editing).
- Click Add Widget to open the picker.
- Choose a tile. Installed plugins appear under a Plugins heading (icon + name) above the built-in types; selecting one drops a widget already wired to that plugin.
Built-in widget types
| Widget | Shows |
|---|---|
| Stat Card | A single metric (item count, total, commits, baselines). |
| Bar Chart | Items grouped by a field, as bars. |
| Pie Chart | A distribution, as a donut. |
| Trend Line | Item count over time, with granularity and range. |
| Item Table | A list of items matching a query. |
| Traceability Matrix | A coverage matrix between two item types. |
| Activity Feed | Recent commits — author, relative time, baseline tag, and clickable affected-item chips. |
| Text / Notes | Free-form markdown — headings, instructions. |
| Custom (HTML/JS) | A small inline widget authored in place (requires the widget-author permission). |
Configuring a widget
In edit mode, click a widget’s gear icon → Configure. Every widget has:
- a Title;
- type-specific options (a chart’s group by, a table’s max rows, …);
- a Filter Query on data widgets — the same query language as the Items page (leave empty to show everything);
- Parameters (JSON) on plugins and custom widgets — a free-form object the
app receives at runtime, e.g.
{ "documentId": "D-ROP-2", "mode": "compact" }; - a Full screen toggle — the widget fills the dashboard content area (the header and sidebar stay); only that widget is shown while it’s on. Handy for editor-style plugins. Turn it off again from the same Configure dialog.
Then Drag widgets to reorder, resize them by their edges, and remove them with the delete button. Click Save to commit your changes (or Cancel to discard them) and leave edit mode.
The same plugin, configured per dashboard
A plugin dropped on two dashboards is two independent instances — each keeps its own settings (a table plugin can show different columns on each dashboard, for example). Most plugins store this per-instance configuration themselves (through their own settings UI), so configuring one instance never affects the other.