Complications & Widgets

You don’t always need to open the app. Complications put data right on your wrist, Control Center gives you quick toggles, and Siri handles voice.

Complications

Glance at your wrist to see temperature, lock status, or how many lights are on — and much more.

Complications are built in Home Assistant, in the Wrist Assistant panel in the sidebar. It needs Wrist Assistant integration 3.0 or later, and only a Home Assistant administrator sees it. See Complication Editor for how to open it and how the editor works.

Complications are free on every tier. The old limit of one complication in free mode is gone, and custom icons are free too.

To put one on your watch face, long-press the face → Edit → pick it by name under Wrist Assistant Circular, Rectangular, Corner, or Inline. After a change in the panel, open the Wrist Assistant app on your watch so it pulls the new design.

The same panel builds Lock Screen and Home Screen widgets for your iPhone. Add them from the iPhone widget gallery under Wrist Assistant. Complication Toggle and Complication Button controls are there too, for Control Center and the Action button.

Upgrading from an earlier version

Before Wrist Assistant 3.0, complications were built in the iPhone app’s Widgets tab. Those complications move into Home Assistant on their own. There is nothing to add again.

They keep working. Your watch faces keep the old complications until the watch has the new ones, with the same names in the same places.
Open the watch app once. That is the only step. The watch pulls the moved designs, and the faces switch over. If the move is for a second home, switch the watch to that home.
Follow it on the iPhone. The Widgets tab shows the move while it runs, and says so if it is waiting for the watch or for an integration update. When it is done, the tab shows one card that points to the Wrist Assistant panel, with Open in Home Assistant.
Update the integration first. The move needs integration 3.0 or later. Until you update it in HACS and restart Home Assistant, the Widgets tab asks you to, and your old complications keep working.
One design per shape. Each moved complication becomes one design for each shape (Circular, Rectangular, Corner, Inline), all with the same name. Delete the shapes you don’t use in the panel.

Tap Actions

The whole face has a tap action, and any layer can have its own. In the editor they are grouped like this:

Refresh: Refresh this complication, or refresh several complications at once.
Pages: Show the next page, the previous page, one page, or play all pages in turn.
Home Assistant: Toggle an entity, run a scene, run a script, call a service, run an HTTP Action, or add a to-do.
Open the app: Open the app, a watch app page, an entity, or the page for the room you’re in. A watch app page can be a hidden page if a Peek Page tile already targets it and you have the Multiple Pages Pro feature (see Page Peek → Hidden Pages).
Timer: Start or pause a Home Assistant timer. Tap three times quickly to cancel.

Refresh

Each complication has an Auto refresh setting: None, or every 15 or 30 minutes, 1 hour, or 2 hours. A Refresh tap action updates it on demand. watchOS limits how often a complication actually refreshes. That is an Apple restriction the app can’t override.

Control Center

On watchOS 26 and later, Wrist Assistant adds toggles and actions to your watch’s Control Center (press the side button).

Entity Toggle — On/off buttons for lights, switches, fans, locks, etc. Run Action — One-tap scene, script, or automation buttons.

Add them by pressing the side button → scroll down → Edit → find Wrist Assistant. Configure which entities show up in Settings → Watch Control Center.

Smart Stack Widgets

Wrist Assistant is also available in the Smart Stack (swipe up from your watch). Add it by scrolling to the bottom of the Smart Stack → tap Edit → find Wrist Assistant.

Siri Shortcuts

Control your home through Siri using these built-in voice phrases:

“Toggle the porch light with Wrist Assistant”
“Turn on / Turn off the porch light with Wrist Assistant”
“Activate movie night with Wrist Assistant”
“Lock the front door with Wrist Assistant”
“Unlock the front door with Wrist Assistant”
“Close the blinds with Wrist Assistant”
“Play the kitchen speaker with Wrist Assistant”
“Check the front door with Wrist Assistant”
“Show [page] status with Wrist Assistant” — opens a status page as a Siri response view
“Quick Wrist Assistant” — dictate an item to add to your configured Home Assistant to-do list

In the Shortcuts app

Beyond the spoken phrases above, more actions are available in the Shortcuts app for manual shortcuts and time/location-based automations. You can build these into your own shortcuts:

Toggle Entity
Activate Scene
Get Entity State
Lock / Unlock
Close Cover
Play/Pause Media
Add to List
Run HTTP Action — fire one from your HTTP Actions library
Get Camera Image — returns a still snapshot from a camera as an image you can pass to the rest of your shortcut
Show Status Page

A few actions stay Siri-voice / automation only and don’t appear as standalone, buildable steps in the Shortcuts library: Run Script, Run Automation, Open Cover, Set Brightness, and Set Temperature.

Combine these with Focus Filters for fully automated scenes — your phone switches to Sleep Focus, and your lights dim automatically.