Editing Your Dashboard
How to enter edit mode, arrange widgets, and what every gesture does in both live and edit mode.
Tap the pencil
The pencil icon in the header opens edit mode. A faint grid overlay appears.
Rearrange
Move, resize, add, remove. Every action saves automatically.
Tap Done
Returns to the live dashboard. No Save or Discard buttons; changes are already persisted.
Gestures
The same input produces different effects depending on whether you are in live mode or edit mode.
| Gesture (desktop) | Gesture (touch) | Live mode | Edit mode |
|---|---|---|---|
| Click | Tap | Primary action (toggle, run scene) | Select widget |
| Click and hold 500 ms | Long-press 500 ms | Open detail dialog (device controls) | (n/a) |
| Click and hold 300 ms | Long-press 300 ms | (n/a) | Pick up tile (start drag) |
| Click and drag inside tile | (detail dialog) | Adjust primary value (brightness, cover) | (n/a) |
| Drag | Drag (after pickup) | (n/a) | Move tile; surrounding widgets reflow |
| Drag corner grip | Drag corner grip | (n/a) | Resize tile |
Pickup in edit mode is intentionally faster (300 ms vs 500 ms) because accidental drags are easy to undo by dropping in place, whereas an accidental detail dialog opening in live mode is more disruptive.
Why mobile skips in-tile sliders
In-tile sliders fought with page scroll on touch. No heuristic reliably told a deliberate slide from a scroll. Moving fine control into the detail dialog kept gestures predictable and page scroll snappy. On desktop the mouse uses a wheel for scrolling, so the conflict does not exist and in-tile drag stays.
Adding
In edit mode, tap Add Widget in the header. Pick a widget from the picker and it lands in the first free spot at the current breakpoint. Drag it where you want, then tap Done.
For widget types, community widgets, and building your own, see Widgets.
Moving
Desktop
Click and hold for 300 ms to pick up, then drag. Drop on any free space; surrounding widgets reflow.
Mobile
Long-press for 300 ms until you feel a haptic bump, then drag. Quick swipes scroll the page; page scrolling also works in the gaps between widgets.
Autoscroll while dragging
Drag a picked widget toward the top or bottom edge of the screen and the page scrolls automatically. You can place a widget anywhere on a long dashboard without dropping it.
Resizing
Drag the small grip at the bottom-right corner of any widget. The touch hit area extends beyond the visible grip so even 1x1 tiles are resizable with a finger. Each widget declares its own min and max size; the grip stops when you reach a limit.
Removing
In edit mode each widget shows an X in the top-right corner. Tap it and the widget is gone, with no confirmation prompt. The widget stays installed locally and can be re-added from the picker.
Widget settings (config dialog)
To configure a widget’s bound entity, display options, size, or color: tap the gear or edit affordance that appears on the widget while in edit mode. The config dialog opens with fields auto-generated from the widget’s schema. Changes save instantly, no apply button.