Layout Editor

The iPhone app is where you design your watch layout. Everything syncs automatically.

This page is the full editor reference. Jump to: Adding Devices · Editing a Tile · Confirmation & Tap Actions · Hold-and-Slide · Trigger Entity · Tile Visibility · Managing Pages · Multi-Select · Syncing to Watch. The radial menus are built in the separate Quick Menu Editor.

The Preview

A watch-shaped preview at the top of the editor shows roughly how your layout will look on your wrist. It matches your actual watch screen size — what you see is what you get. The preview shrinks automatically when you tap into a text field so the keyboard doesn’t cover your workspace, and restores on dismiss.

Adding Devices

Tap the + Add button on the right-hand side toolbar to open the Add Entities overlay. A 4-column grid of entity categories — Controls (lights, switches, locks, covers, scenes, scripts), Climate, Media, Automation, Sensors, and Inputs — fills the screen. Tap a category and the matching entities from your Home Assistant appear. Each tap commits the entity immediately, so you can keep adding without leaving the overlay. Pull down from the top of the grid to dismiss, or tap Done in the pinned bottom bar.

The bottom bar also has a tappable search field that opens a full-entity search sheet for finding anything by name or entity ID.

You can also add an HTTP Action tile here — a standalone tile that fires a user-defined HTTP request straight from your wrist.

By type — All lights, all switches, all cameras, and so on — grouped into one tidy category tile each.
Search — Full-text across every entity in your Home Assistant.
Smart Pages — Auto-generated pages based on rules (e.g., all lights currently on, all doors open). See Smart Pages.

The same unified category picker is used across the app — Control Center, Status Page editor, and preset sheets all share it.

Arranging Tiles

Drag tiles to rearrange. Resize by tapping a tile and adjusting the size stepper, or dragging the resize handles.

Editing a Tile

Tap any tile to open its settings.

Size — Make important tiles bigger, keep secondary ones compact. Default is 6x4. Tiles go from 1x1 up to 12 wide by any height — a single tile can fill the entire screen.
Entity-specific tabs — When editing a tile, domain-specific tabs (like Remote, Camera, Music, Template) appear first in the tab bar with a highlighted border so you can find the relevant settings immediately. Tab labels adapt to the entity type — “Data” becomes “Remote” for remotes, “Vacuum” for vacuums, “Assist” for voice hubs.
Icons — Thousands of SF Symbols to choose from, with suggested icons tailored to each entity type. Default icons change automatically based on state — lightbulb fills in when on, lock shows locked/unlocked. Or pick any icon you want. Long-press any icon in the picker to favorite it — favorited icons get a star and are pinned to the Favorites chip in the category row, so the ones you reuse are always one tap away. Long-press again to unfavorite.
Colors — Set background, icon, and label colors independently. Different colors for active and inactive states.
State Icons & Colors — Just below the main Icon & Color controls on the Icon tab, the State Icons & Colors section gives each entity state its own icon and/or color. Style a cover’s Open / Closed / Opening / Closing, a lock’s Jammed state, a climate tile per HVAC mode (Heat, Cool, Auto…), and more. Rows are filtered to the states a device can actually reach — driven by its hvac_modes, supported_features, and device_class — so you only see options that apply. Any row you leave untouched inherits the tile’s single icon and color (a solid swatch and full-strength glyph mean the state is overridden; a hollow ring and dimmed glyph mean it’s inherited). Each row has a reset to clear just that state, plus a Clear State Overrides action to wipe them all, and a mini-tile preview on every row shows exactly how the watch will render that state. State Icons & Colors is part of the Pro Advanced Styling feature. Pairs naturally with Dim When Off — turn it off to render on and off at full color (e.g. green on, red off).
Dim When Off — A toggle in the Icon tab’s Display card. On by default: when the device is off or inactive, the watch tile is desaturated and darkened so a glance tells you what’s running. Turn it off and the tile renders on and off identically, at full color — handy when you’ve set your own State Icons & Colors and want those colors to define each state (e.g. green on, red off) instead of the automatic dimming. The toggle only appears for tiles whose state has a real on/off signal — lights, switches, locks, fans, media players, remotes, sirens, timers, vacuums, alarm panels, automations, and toggle helpers; it’s hidden for covers, climate, scenes, buttons, and non-dimming sensors, which already render at full strength. It’s free, and works across a multi-select so you can flip a whole batch of tiles at once.
Labels — Show the entity name, custom text, or hide the label and go icon-only. Numeric values can display as plain text, a fill bar (like a battery indicator), or a pill badge. Sensors show their value in a top-left corner badge — including named states like Open/Closed, Motion/Clear, Low/Normal on binary sensors (Home Assistant device class labels).
Patterns — Background patterns help differentiate tile types at a glance. Choose from stripes, dots, crosshatch, checkerboard, lines, grid, diamond, gradient, waves, zigzag, sunburst, concentric, triangles, hexagons, corner glow, vignette, and noise. Adjustable color, opacity, and scale.
Borders — Custom borders with adjustable width, color, and corner radius. Borders can also be animated — pulse, shimmer, rainbow, chase, sparkle, comet, and others. Animated borders may use more battery.
Animations — Tiles can animate on state change, while a device is active, or on tap — pulse, shake, bounce, glow, and others. Tiles can also have overlay effects — animated backgrounds like aurora, rain, fire, sparkle, snow, stars, confetti, bubbles, bokeh, wisps, matrix, plasma, radar, fireflies, scanlines, electric, and more. Animations may use more battery.
Value Bars — For tiles showing a percentage (brightness, volume, position), add a visual bar across the top, bottom, or as a fill.
State Text & Status Icon Size — On the State Display tab (named Brightness Display, Speed Display, Value Display, Count Display, etc., depending on the domain), drag the State Text Size slider (4–16 pt) to resize state badges — OFF, percentages, sensor values, countdowns, alarm state. For domains whose activity badge is an icon (climate heat/cool, fan/vacuum running, media play/pause, lawn mower active, remote modes), a separate Icon Size slider (8–24 pt) tunes the overlay icon. Each slider has a reset/clear control so you can drop back to the auto-sized default.
Decimals — Numeric sensor tiles get a Decimals picker on that same State Display tab, just below the value-style picker. Choose 0–3 places for the displayed value — 98.5 at 1, 99 at 0, more precision at 2–3. Values round to the nearest place and trailing zeros are trimmed, so a clean reading shows as 98.5, never 98.50. A space sits between the number and its unit (except for ° and %). Every tile defaults to 1 decimal place, including tiles you created before this option existed. The iPhone preview updates live as you change it.

Confirmation Prompts

Add a confirmation prompt to any tile so it asks “Are you sure?” before toggling. This prevents accidental activations — especially useful for garage doors, locks, alarm panels, or anything with real-world consequences.

Set it up by tapping a tile → Action tab → Confirmation toggle.

Custom Tap Actions

Override the default tap behavior for any tile. For example, set a light’s tap to “turn on” instead of “toggle”, or pick a specific service call. Configure per-tile in the Action tab.

Hold-and-Slide Actions

Beyond tap and long-press, any tile can respond to a hold-and-slide in four directions — up, down, left, and right. Hold a tile and drag to trigger a second action without lifting your finger. Great for lights (hold + up = brighten), covers (hold + down = close), media (hold + right = next track). Configure directions per tile in the editor’s action tab. A direction can also be a Trigger Entity target — fire an action on a different entity entirely (see below) — or set to Run HTTP Action to fire an HTTP Action on slide. As you slide toward a direction, the watch shows a preview label of the resolved action and entity name before you lift to fire.

Trigger Entity

Custom tap actions, hold-and-slide directions, and quick menu slots can all be set to Trigger Entity — an action that fires on any entity, not just the tile you’re editing. Pick a target entity, then pick the action mode for it (the modes offered match the target’s domain — Turn On/Off/Toggle, Lock/Unlock, Open/Close, Activate a scene, Run a script, Trigger an automation, media transport, arm/disarm an alarm, and many more). This replaces the older separate “toggle a device,” “run a scene/script,” and “trigger an automation” choices; existing slots migrate forward automatically.

Radial and quick-menu slots add a Confirm on Release toggle: on means hovering shows a preview label and the action fires when you lift; off means it fires the instant you hover. (Hold-and-slide directions always fire on release.) Trigger Entity is free on custom tap actions and hold-and-slide directions; using it in a Quick Menu (radial) slot is a Pro feature.

Automation Skip Conditions

Automation tiles get an extra Skip Conditions picker on the Action tab (and on individual radial / quick-action slots). Three options: Default (uses the global setting from Watch Behavior → Interactions → Automations), Skip (run the actions without re-checking conditions), or Don’t Skip (evaluate conditions first — fire only if they pass). Triggers are always bypassed in either mode. Default is Skip, matching Home Assistant’s automation.trigger service.

Calendar Tile

Calendar tiles get a dedicated Calendars tab that turns one tile into a merged view of multiple calendar.* entities — useful for combining a personal and work calendar, or for stitching family members’ shared calendars onto a single tile.

The first calendar is the primary: it drives the tile’s icon and title.
Tap + Add Calendar to merge another calendar.* entity. Events from every source are fetched in parallel, combined, and sorted by start time.
Each source gets a swatch-row picker for an accent color — pick one and events from that calendar draw a thin colored bar on the watch so you can tell calendars apart. Colors are opt-in: a source has no bar until you choose a swatch (the first swatch is a “no color” / clear option).
Tap the red − to remove an extra; if you remove the primary, the next calendar in the list is promoted automatically.

Weather Tile

Weather (weather.*) tiles get a dedicated Weather tab — free — that tunes how the watch’s detailed weather view reads at a glance:

Text Size — A slider from 100% to 200% (5% steps, default 150%) that scales only the detail and forecast row fonts — the conditions list and the day-by-day forecast. The header, the current-conditions hero, and the weather icons keep their base size, so the layout stays balanced as the rows grow. A Reset button (shown once you’ve nudged it off the default) drops back to 150%.
Show Icons — On by default. Turn it off to hide the hero condition glyph and the per-row forecast icons, leaving a cleaner text-only readout.

Both settings live on the tile, so each weather tile can be tuned independently and they sync to the watch automatically. See Weather for what the watch view shows.

Alarm Tile

Alarm panel tiles add an Alarm tab with PIN-entry behavior:

Auto-Submit — Once the minimum digit count is reached, the watch submits the code automatically without an explicit Submit tap. Saves a step on short PINs; leave it off if your code length is variable.

Remote Tile

Remote tiles (for TVs, streaming boxes, receivers) have their own editor tab with extras no other tile needs.

Button Layout

Tap Customize Button Layout to open a dedicated editor:

Resizable watch-size preview pinned at the top with a red Reset pill overlay and Save at the top-right.
Button palette scrolls on a darker surface below — Back, Home, Menu, Select, Power, Play, Stop, Prev, Next, −10s, +10s, Shuffle, Repeat, Seek, Source, Sound, Vol arc, Vol+, Vol−, Mute, and Clear.
Drag-and-drop a palette button into any of the 12 slots (drag slot-to-slot to swap), or tap-to-edit: tap a slot to select it, then tap a palette chip to assign. Selected slots stay active so you can iterate quickly.
Palette chips dim when the linked media / volume player doesn’t support that capability (seek, stop, shuffle, repeat, source select, sound modes, volume steps). Tapping a dimmed chip flashes the reason.

Duplicates and empty slots are allowed. Leave a tile’s layout untouched to get the default: Back / Home / Power, Prev / Play-Pause / Next, Menu / Seek / Source, Volume arc / Select / Mute.

Quick Actions (Scripts)

Add Home Assistant scripts as one-tap buttons on the remote’s Quick Actions tab. Each action gets:

A label editable inline (tap the chevron to expand; the keyboard includes a Done toolbar with a blue submit key).
A color via the theme swatch picker — leave empty to fall back to the remote’s accent.
A custom icon from the full SF Symbol browser.

Turn on Require Confirmation (default on) to make buttons tap-to-arm / tap-again-to-fire — buttons show “Confirm?” on first tap and fire on the second within 3 seconds.

The watch lays out quick actions dynamically: 1 button fills the screen, 2 stack tall, 3–4 become 2×2, 5–6 become 3×2, 7+ use 3 columns with the last row centered.

Watch Input

Control how the watch reads input inside the remote:

Select with Crown — Digital Crown rotation triggers Select (the most common remote action).
Reverse = Back — Sub-toggle under Select with Crown (default on). Forward rotation sends Select; backward rotation sends Back. Toggle off for “any direction = select.”
Edge Volume Slide — Slide along a screen edge for quick volume changes. Pick left or right.

Tile Visibility

Any tile can be hidden based on entity state — active only, inactive only, state match, numeric threshold, or based on another entity entirely. Hidden tiles automatically reflow — the others slide up to fill the gap. See Tile Visibility for the full list of rules.

Configure up to 8 quick menu slots per tile. Tap a tile → Quick Menu → add slots with custom icons and colors. Each slot can Trigger Entity (fire an action on any device — toggle, run a scene/script, trigger an automation, and more), switch pages, send a TTS message, broadcast audio, or show a status page.

Managing Pages

Tap back to return to the Pages tab. From here you can:

Add pages — Tap “Add Page” to create a new one
Reorder pages — Drag to rearrange
Rename pages — Tap the page name
Delete pages — Swipe to delete
Mark hidden — Keep a page out of the swipe flow and switcher; only reachable via peek, jump, or room mapping
Page title style — Minimal, Pill, Glass, or hide per page
Background image — Per-page image with fill, fit, or stretch
Themes — Apply a color scheme to an entire page
Smart Pages — Create auto-populating pages based on rules

Multi-Select

Tap the Multi action in the right-hand toolbar to enter multi-select mode, then tap tiles to add or remove them from the selection. With one or more tiles selected, the bottom panel exposes batch edits:

Color — apply the same theme color to every selected tile
Border — None, Extra Thin, Thin, Medium, or Thick
Pattern — background pattern shared across the selection
Icon — pick one icon from the categorized grid for every selected tile
Verify — turn confirmation prompts on/off for the whole selection

Multi-select also supports batch resize and delete. Tap Done in the header to leave the mode.

Syncing to Watch

For the initial sync, make sure both the watch app and the iPhone app are open and in the foreground. After that, changes sync whenever the iPhone app is active and the watch is connected. Toggling any setting forces a sync.