Adding Widgets

Widgets are the building blocks of a dashboard: each one is a chart, a KPI, a table, or another visual tied to your data. You add widgets from the library, which you open with the ] key or the Widgets button in the editor toolbar. The library has three tabs, each a different way to get to the widget you want.

The three ways to add a widget#

A quick gloss of the terms that come up below: a widget is pinned to a dashboard (it appears there, but the underlying widget is shared, not copied); the inspector is the settings panel that opens when you select a widget; and to detach a widget is to remove it from one dashboard without deleting it.

Browsing the catalog#

The All tab is where most widgets start. It lists every widget kind — charts (line, area, bar, column, donut, and the rest), KPIs, tables, text notes, images, embeds, filter controls, and action buttons — with a search box at the top and a live mini-preview on each data-bound card. Type to narrow the list (for example "donut" or "table"), then add the one you want.

Whatever kind you start from, you can switch it in the inspector after placing it. This includes the less common kinds (treemap, radar, boxplot, sankey, sunburst, calendar heatmap, and similar): each one gives you a working field editor for picking the columns it needs, so you are not limited to the everyday charts.

Gauge, meter, and progress are chart kinds (the "single value" family), so you find them in the catalog alongside line, bar, and the rest.

Placing a widget: click or drag#

This works the same way no matter which tab you added from. Clicking a library entry adds the widget at the next open spot on the grid. To place it precisely, drag it from the library onto the canvas: a ghost outline shows where it will land before you drop it. Once placed, drag the widget to move it and drag an edge to resize. The layout saves automatically.

On a brand-new, empty dashboard you do not even need to open the library first: the canvas shows an Add a widget prompt that opens the same chooser.

Reusing a widget you already built#

The Workspace tab lists every widget in your workspace. Adding one from here pins it onto the current dashboard rather than making a copy: it is the same widget, shown in more than one place. Edit it once and the change shows everywhere it is pinned. Each entry shows how many dashboards use it (for example "Used on 3 dashboards") and marks the ones already pinned to the current dashboard, so you can see at a glance whether changing it will ripple to other dashboards.

More than charts#

Not every widget is a chart. The All tab lists every kind, charts and non-charts alike — search or scroll to find these:

Removing a widget from a dashboard#

There are two ways to take a widget off a dashboard, and both ask you to confirm:

• From the Dashboard tab of the library, find the widget and click its trash icon.
• Or select the widget on the canvas (its settings open in the inspector) and click ✕ Remove from dashboard at the bottom of the inspector.

Either way this detaches it from this dashboard only: the widget stays in your library, so any other dashboard that pins it is unaffected and you can re-add it later.

Related guides#

• Binding data: point a widget at a feed and choose what to group by and measure.
• The chart kind catalog: every chart kind and when to use it.
• KPI, table & gauge widgets: configure the non-chart widget types, including a table's per-column formats.
• Templates: the portable way to reuse a widget or a whole dashboard layout across workspaces.
• Publishing and sharing: share a widget or dashboard with people outside the editor.