Skip to content
DRAFTEnglish end user manual · web beta f7b7740e7371 · Android beta ed5d9494be9eDownload PDF

Widget Builder

The Widget Builder turns governed catalog data into a dashboard widget. It lets you choose a source, select fields, configure the visualization, preview the result, and close the editor after the instant save completes.

The builder reads the catalog instead of asking you to type technical identifiers. You select business-friendly field names, metrics, dimensions, filters, timelines, and display options. Rokks compiles the selection into a query and returns preview rows. In the dashboard flow, edits apply immediately; the footer shows Close, not a separate Save action.

The reviewed beta capture below shows the real editor frame, its catalog-backed schema canvas, live-preview area, and the All changes saved footer. The particular fields depend on the data source and widget you open.

BETA PRODUCTVerified product capture · build f7b7740e
ACME Widget Builder editing a public sample-data table
Reviewed ACME beta capture of the Widget Builder data-model screen.Captured 12 Sept 2026 UTCOpen documented view ↗
  1. Open a dashboard.
  2. Click Add Widget or edit an existing widget.
  3. Choose a data source.
  4. Select the visualization type.
  5. Add metrics, dimensions, time fields, filters, sorting, or table columns.
  6. Review the live preview.
  7. Wait for the instant save to finish, then click Close.

For a chat-driven alternative, ask Sidekick to inspect the governed source in Ask mode, then switch to Agent for one named widget. The dashboard authoring cookbook keeps query compilation and review as an explicit checkpoint.

Do not build a widget before the source metadata is clean. Poor names and wrong types make the builder harder to use.

Do not use a chart type just because it is visually interesting. Choose the type that answers the question.