Back to Cube

Widgets

docs-mintlify/docs/explore-analyze/dashboards/widgets/index.mdx

1.7.203.1 KB
Original Source

Widgets are the building blocks of a dashboard. Each tile placed on the canvas in the dashboard builder is a widget — a chart, a block of text, a control that viewers interact with, an AI-generated summary, or a layout element such as a spacer or divider. Combine them to assemble polished, interactive views of your data.

Widget types

The dashboard builder supports the following widget types:

  • Charts — Visualize reports from your workbook
  • Text — Add titles, descriptions, and rich formatting in Markdown
  • Controls — Let viewers filter the data or switch the time granularity
  • AI summary — Generate narrative summaries of dashboard data on demand
  • Spacer & Divider — Non-data layout elements for whitespace and section breaks (in preview)

Adding widgets

Add widgets from the toolbar at the top of the dashboard builder: pick reports from the Charts picker to add charts, use the Add Widgets menu for text, AI summaries, and layout elements, or add a Filter or Time Granularity control from the Add Controls group.

Each toolbar item can be added in two ways:

  • Click it to drop the widget into the first open spot on the canvas.
  • Drag it from the toolbar onto the canvas to place it exactly where you want. As you drag, a full-size placeholder previews the widget's footprint and the surrounding widgets reflow to open a slot; release to drop it there. Dragging is especially handy on dense dashboards, where clicking would otherwise place the new widget far down the page.
<Warning>

Dragging a toolbar item to place it exactly (drag-to-place) is currently in preview, and the behavior may still change. Reach out to the Cube support team to activate it for your account. Clicking to add a widget is available to everyone.

</Warning>

Arranging widgets

Drag any widget to move it, and use the handle in its bottom-right corner to resize it — the surrounding widgets shift to make room.

<Warning>

Selecting multiple widgets and moving or deleting them as a group is currently in preview, and the behavior may still change. Reach out to the Cube support team to activate it for your account.

</Warning>

To work with several widgets at once, select them first:

  • Click a widget to select it.
  • Shift-click to add widgets to, or remove them from, the selection.
  • Drag a marquee — press on any empty part of the canvas and drag a rectangle over the widgets you want; every widget it touches is selected.

With a selection in place:

  • Move the group — drag any selected widget and the whole selection moves together, keeping its relative arrangement.
  • Delete the group — press Delete or Backspace to remove every selected widget at once.