Layouts
A layout determines how panels are arranged on a display device. Each board has one active layout, and you can change it at any time through the mobile app.
Layout presets
| Layout | Panels | Valid panelId | Description |
|---|---|---|---|
| Full Screen | 1 | 1 | Single panel fills the entire display. |
| Stacked | 2 | 1–2 | Top (1) and bottom (2) horizontal panels. |
| Side by Side | 2 | 1–2 | Left (1) and right (2) vertical panels. |
| 2×2 Grid | 4 | 1–4 | Top-left (1), top-right (2), bottom-left (3), bottom-right (4). |
Choosing a layout
Pick a layout based on how many different pieces of information you want on screen at once:
- Full Screen — best for a single prominent message (alerts, status, hero text)
- Stacked / Side by Side — good for two independent data streams (e.g., deploy status + queue depth)
- 2×2 Grid — ideal for dashboards with four metrics or data sources
Layouts are configured per board through the mobile app.
Targeting panels
When you send an update, use the panelId field to target a specific panel. If you omit panelId, the update goes to panel 1 by default.
{
"boardId": "<board-id>",
"panelId": 2,
"blocks": [{ "text": "Right panel content" }]
}Updating one panel doesn't affect the others. Each panel holds its own content independently.