Apple Watch widget missing instuctions or bug

[tamet83]

iOS device model, version and app version
Apple Watch Series 9
WhatchOS 26.4

Model Name:
App version: 2026.4.1

Home Assistant Core Version
2026.4.4

Describe the bug
I don't understand how to setup Widget on WhatchOS.
Official documentation does not provide any information about widget.

To Reproduce

1. On my iPhone I opened the Home Assistant app → Settings → Apple Watch → Configuration and added my script to the list of available items.
2. On the watch I swipe up to open the widgets screen, tap “Add Widget”, find the Home Assistant app and select the “Scripts” widget.
3. The widget appears but shows the label “Choose script” (or similar). I cannot select which script the widget should use. Tapping the widget or trying to configure it on the watch does nothing. Other entity types behave similarly.
4. Despite this, I can still run the same script by opening the Home Assistant app on the watch (so the script itself works).

Expected behavior

• Expected: be able to pick a specific script (or other entity) for the widget so it displays and triggers that script directly.
• Actual: widget shows “Choose script” and there is no way to select the target entity from the watch UI.
  Screenshots

Additional context

1. Is there an extra step I miss to bind a script (or another entity) to the watch widget?
2. Are widgets on watchOS 26 handled differently (complications vs widgets) and Home Assistant requires a specific method?
3. Are there known bugs or known minimum versions of iOS/watchOS / companion app for this to work?
4. If anyone has screenshots of a working widget configuration or exact step-by-step instructions, that would be very helpful.

[bgoncal]

On my iPhone I opened the Home Assistant app → Settings → Apple Watch → Configuration and added my script to the list of available items.

This is to add items to the Home Assistant watch app (you see when the app is open)

On my iPhone I opened the Home Assistant app → Settings → Apple Watch → Configuration and added my script to the list of available items.
The widget appears but shows the label “Choose script” (or similar). I cannot select which script the widget should use. Tapping the widget or trying to configure it on the watch does nothing. Other entity types behave similarly.

Our watch app does not support widgets, I am curious what you are seeing.

[tamet83]

On my iPhone I opened the Home Assistant app → Settings → Apple Watch → Configuration and added my script to the list of available items.

This is to add items to the Home Assistant watch app (you see when the app is open)

On my iPhone I opened the Home Assistant app → Settings → Apple Watch → Configuration and added my script to the list of available items.
The widget appears but shows the label “Choose script” (or similar). I cannot select which script the widget should use. Tapping the widget or trying to configure it on the watch does nothing. Other entity types behave similarly.

Our watch app does not support widgets, I am curious what you are seeing.

Thanks for your response, this is what I see when I choose Home Assistant Widget on Apple Watch:

[bgoncal]

I've never seen this before 🤯 they weren't supposed to be visible in the watch, can you confirm from which of these screens you are trying to add "widgets"?

1:

2:

[tamet83]

@bgoncal when you activate the widget management and then choose home assistant:

[bgoncal]

I know how to get there but Home Assistant does not show up for me, thats why I was surprised.

Well, short answer is, we don't (intentionally) support widgets on Apple Watch.

[tamet83]

I know how to get there but Home Assistant does not show up for me, thats why I was surprised.

Well, short answer is, we don't (intentionally) support widgets on Apple Watch.

Thanks for your quick reply. I hope this will be implemented in the future like it is on iOS.