Layouts

Layouts define how dynamic widget content is rendered on your home screen. Each layout is JSON validated by Glance and tied to one widget size.

Widget sizes

Extra Large is the iOS 27 portrait page, a 4×6 slot. Creating that size needs Pro or Power. Pinning it on the Home Screen needs iOS 27 or newer. Design the page as more than one region. A large layout scaled up does not fill it. The reference is xl-morning-brief.

Create a layout manually

1. Open Layouts from the bottom navigation in the iOS app.
2. Tap + and choose Layout, or tap Create Layout on the Layouts tab.
3. Give your layout a name, pick a widget size, and paste or edit the layout JSON.
4. Tap Save. Glance validates the JSON and derives the content schema automatically.

Minimal layout example

A small widget with a caption and hero stat. Dynamic fields use {{double_braces}}; static labels use plain strings.

{
  "id": "root",
  "type": "container",
  "layout": "vertical",
  "style": { "padding": 12, "spacing": 8 },
  "children": [
    {
      "id": "label",
      "type": "text",
      "binding": "Today's revenue",
      "style": { "fontSize": 12, "color": "#8E8E93", "maxLines": 1 }
    },
    {
      "id": "value",
      "type": "stat",
      "value": "{{revenue}}",
      "style": { "valueFontSize": 28, "color": "#000000" }
    }
  ]
}

A saved layout is the default. On Pro and Power you can skip saving one and send the tree with the update — UI on Demand. That path does not create a row here and does not spend a layout slot. See Dynamic Ingest.

Learn the layout language

• Design System — principles, canvas, bindings, typography
• Components — every registry type, bindings, and style fields
• Golden Examples — reference layouts for each size