Container

Docs / Widgets / Layout / Container
Layout widget

Container

A Container groups related widgets into one tile, so a busy dashboard stays tidy. Tap the container to open it and see the widgets inside, like a folder of apps on a phone.

Layout onlyGroups 2+ widgetsNo device codeOpens its own canvas

Try it

Press Start Clubbing, tap two or more widgets, give the container a name like Pump room, then press Finish Clubbing. Tap the container to open it. The widgets inside keep working.

SimulationLIVE
Dashboard
Press Start Clubbing, then tap two or more widgets.
Widgets keep working insideMoving a widget into a container doesn't change its Telemetry Point or settings; it only changes where it sits on the dashboard.

How to add and set up

  1. Open the dashboardOpen the device. Clubbing works in normal view, not in edit mode.
  2. Start ClubbingOpen the dashboard menu and choose Start Clubbing.
  3. Select the widgetsTap two or more widgets to select them.
  4. Finish Clubbing and name itChoose Finish Clubbing and type a name, for example Dehradun Site or Bedroom 2. The container appears on the dashboard with that name.
  5. Open itTap the container. It opens over the dashboard with its widgets inside. Tap the back arrow at the top left to close.
  6. Add more laterIn edit mode, drag a widget onto the container and confirm Move Widget to put it inside.

Settings

ActionWhat it does
RenameChanges the name shown under the container (edit mode → container menu).
UngroupPuts every widget back on the dashboard and removes the container.
Remove from ContainerOn a widget inside: moves just that widget back out.
InfoA short card about the container.

How it looks

On the dashboard a container is drawn like an app folder on a phone: a frosted square with up to three big tiles and, in the fourth corner, a small group of the rest. Each tile is a tiny live version of its widget — a switch shows its state, an LED its glow, a graph its curve — in a colour per widget type. A container needs at least two widgets.

Code for your device

A Container needs no code of its own. The widgets inside keep their Telemetry Points, so your board reads and writes them exactly as on the main dashboard.

C++ · Arduino
SME_LISTEN(TP0)              // a Switch inside the container
{
  digitalWrite(PUMP_PIN, data.toInt());
}

SME.publish(TP1, reading);   // a Value or Gauge inside the container

See the guide for each widget for its code: Switch, Button, Slider, LED, Value, Gauge and Graph.

SwitchSimple on/off control that stays where you leave it.ValueShows the exact reading with its unit.
Was this page helpful?