Managing widgets

A widget is a saved workspace resource. A dashboard contains placements of that resource: its position, size, and optional dashboard-only title or frame. This means one widget can appear on several dashboards, or more than once on the same dashboard, while keeping one canonical data and style definition.

Find and understand a widget#

Open Widgets beside Dashboards. The card grid shows saved widgets rather than the chart-type catalog. Its compact top toolbar keeps the filters and creation action together; choose the search icon to expand search. Search matches names, widget types, tags, and source details, while filters narrow the list to Charts, Controls, BankSync widgets, Custom widgets, or your drafts.

Each card gives you the information needed before opening it:

• the widget icon, name, and meaningful status;
• its primary feed, bank, table, or query, plus any additional sources;
• the number of transformations applied to its data;
• the widget type; and
• its total source-and-dashboard dependency count.

Editors can drag cards to set the workspace-wide order while All is selected and search is empty. Ordering pauses during filtering so hidden widgets never move unexpectedly.

Preview and configure#

Select a card to open its responsive detail pane. Existing widgets always open on Preview. A newly created data-bound widget opens on Data for its first setup.

The tabs have distinct jobs:

• Preview renders the real widget in a dashboard-faithful frame. It opens at Full width; choose a common size or resize the frame directly, then add another placement to a dashboard when it is ready.
• Data chooses feeds, live banks, tables, queries, fields, and transformations.
• Style changes the canonical widget presentation.
• Share controls visibility and truthful publish/embed capabilities.
• Dependencies shows every upstream source and every dashboard placement.
• Advanced contains diagnostics, identifiers, deletion, and custom-widget studio actions.

Routine edits autosave. The header shows Saving, Saved, or an error state using the same treatment as feeds and enrichments.

Reuse a saved widget#

From Preview, choose Add to dashboard, then select one eligible dashboard. BankSync places it in the next available space. Repeat the action to add another placement; every placement remains independently movable, resizable, lockable, and removable.

Inside a dashboard, the compact Add a widget pane remains available. Choose Browse all for the larger visual catalog. Both surfaces use the same Create, Saved widgets, and Packages catalog, so type names, maturity badges, previews, and custom-widget entry points stay consistent.

Dependencies and deletion#

Dependencies are grouped into:

• Reads from: feeds, banks, tables, queries, derived/static nodes, and custom-widget inputs, including missing or permission-needed states.
• Used in dashboards: each dashboard with its individual placements and title overrides.

A widget that is still in use cannot be deleted. The confirmation dialog offers View dependencies so you can open each dashboard and remove or replace its placements explicitly. Removing a placement never deletes the saved widget. Once no dashboard uses it, you can confirm permanent deletion from Advanced.

Custom widgets#

Custom widgets use the same cards, Preview, Data, Style, Share, and Dependencies experience. Choose Open studio for source code, Setup, Contract, builds, generated fixtures, and sandbox diagnostics. Closing the studio returns to the widget's Preview-first resource pane.

Custom packages keep their existing version, binding, consent, and grant rules; the Widgets tab does not create a second runtime or permission path.

Related guides#

• Dashboards & Widgets Overview
• Adding widgets
• Binding data
• Custom-widget data and permissions