Home Assistant widgets on the iPhone Home Screen and Lock Screen
The official Home Assistant app offers widgets for Assist, scripts, sensors, gauges, details, energy, calendars and pages, in Home Screen and Lock Screen sizes. iOS refreshes widgets on a budget, about every 15 minutes for sensors, so a widget is a glance, not a live view. For live progress, use a Live Activity.
Add a widget
Touch and hold an empty area of the Home Screen or Lock Screen, tap Edit, then Add Widget, and pick the Home Assistant app (or another Home Assistant app that offers widgets). Most widgets ask you to pick an entity, script or template after you place them: touch and hold the widget and choose Edit Widget.
Widgets in the official app
The official app offers these widget types, according to its documentation. Home Screen widgets come in small, medium and large; Lock Screen widgets in the circular, inline and rectangular sizes.
- Assist: Opens Assist with the pipeline of your choice
- Scripts: Runs a script with a tap
- Sensors: Shows sensor values
- Open Page: Opens a Home Assistant page in the app
- Gauge and Details: Show values from templates
- Energy and Calendar: Your energy dashboard and upcoming calendar events (added in August 2026)
- Custom widgets (beta): The most configurable type
How often widgets refresh
iOS decides when a widget refreshes and gives each app a limited budget. The official documentation puts sensor widgets at about every 15 minutes. To refresh sooner, an automation can send the app a silent push notification with the message update_widgets, for example whenever the entity a widget shows changes. Anything that changes by the second, such as a washing machine cycle, belongs in a Live Activity instead.
Widget not updating?
Most stale widgets are the refresh budget at work, not a fault. Work through these in order.
- Check Home Assistant first: If the entity's state is old in Home Assistant too, the widget is showing it correctly
- Open the app: Opening it, or tapping an interactive widget, usually refreshes its widgets
- Show the last update time: The official app's widgets have an option that shows when the widget last refreshed
- Push a refresh: In the official app, send the update_widgets notification command from an automation when the entity changes. It refreshes Gauge and Details widgets, iOS may still decline, and manual reloads are limited to around 40 to 70 a day
- Keep it visible: iOS weighs how often you look at a widget, so a widget on a page you rarely open refreshes less
- Use a Live Activity for anything that changes by the minute
action: notify.mobile_app_your_iphone
data:
message: update_widgetsWidgets in Vulpo
Vulpo offers eight widget types for the Home Screen: toggle, group, solar, chart, person, camera, lock and cover. Solar, chart and person are also available on the Lock Screen. Interactive widgets toggle the entity in place without opening the app. Two widgets are free; Vulpo Pro removes the limit and adds the Group widget, which shows up to eight entities as tiles. Vulpo is made by the publisher of this site.


Questions
Can a Home Assistant widget toggle a light without opening the app?
Yes, with an interactive widget. In the official app, a Scripts widget runs a script in place. In Vulpo, the toggle, group, lock and cover widgets act on the entity directly.
Why does my widget show an old value?
iOS limits how often widgets refresh. Opening the app or tapping an interactive widget usually refreshes it, and the official app can be asked to refresh widgets through an update_widgets notification.
Sources
Sources3
Facts about other apps come from their App Store listings and documentation as of the date above. Home Assistant is a trademark of the Open Home Foundation; Vulpo is not affiliated with it. Corrections: josh@vulpo.app.
Widgets & Live Activities in VulpoMore guides
- , 3 min read
Home Assistant Live Activities
How to show a washing machine, vacuum or other Home Assistant process as a Live Activity on the iPhone Lock Screen: the official app, Vulpo and two more apps. - , 2 min read
Home Assistant in Control Center
How to add Home Assistant controls to iPhone Control Center, the Lock Screen and the Action button with the official app, Shortcuts or Vulpo. - , 12 min read
Best Home Assistant dashboards
Sections, Mushroom, Bubble Card, Magic Frame and native iPhone and iPad apps compared: what each costs, where it runs and who it suits, November 2026.
Joshua Dessol













