Planning iPhone Widgets for Your App: Home Screen and Lock Screen

A widget shows a small piece of your app’s information on the iPhone Home Screen or Lock Screen, so people can check it without opening the app. The best widgets answer one question at a glance, such as “How many days until my trip?” or “What’s my next booking?”

What widgets are good for

  • Information people check often, such as a countdown, their next appointment or progress toward a goal.
  • A quick way into a specific screen of your app.
  • Simple actions such as marking a task as done. Since iOS 17, widgets can include buttons and toggles for this. On a locked iPhone, these controls only work after the person unlocks it.

A widget isn’t a small version of your app. Complete workflows such as booking or checkout belong in the app. For an event that changes minute by minute, such as a delivery on its way, Apple provides Live Activities instead.

Where widgets appear

  • Home Screen: small, medium and large sizes, plus extra large on iPad.
  • Lock Screen: compact circular, rectangular and single-line inline styles.
  • StandBy: when a charging iPhone is turned on its side, small widgets can be shown at a larger size.

You don’t need every size. Choose the places where your information is most useful and design each size for what fits there.

How widgets stay up to date

A widget doesn’t run all the time. The app gives iOS a timeline of what the widget should show and when, and iOS decides when to refresh it. Apple limits how often each widget can refresh, so a widget can’t rely on constant updates.

  • Countdowns and timers don’t need a refresh every second. iOS can update a displayed countdown or timer on its own.
  • When data changes in the app, such as an edited event, the app can ask iOS to reload the widget.
  • The widget runs separately from your app, so any data it needs from the app must be stored where both can read it, such as a shared app group.

What to include in your widget brief

  1. The question each widget answers. Keep it to one per widget.
  2. Sizes and places: which Home Screen and Lock Screen styles you need.
  3. Options: whether people can choose what a widget shows, such as which event to count down to.
  4. Empty and loading states: what appears before someone adds data or signs in.
  5. How fresh the data must be, and where it comes from.
  6. Where a tap goes in the app.
  7. Privacy: the Lock Screen is visible while the phone is locked, so decide what should be hidden there.
  8. Appearance: how the widget looks in light mode, dark mode and the tinted look people can choose for their Home Screen.

Example: an event countdown widget

Question it answers
How long until my next event?
Sizes and places
A small Home Screen widget showing one event and the days left, and a rectangular Lock Screen widget with the event name and days left.
Options
People choose which event each widget shows.
Empty state
“Add an event to start a countdown,” opening the app’s add-event screen.
Tap
Opens that event in the app.

Our Countdown – Event & Widget app brings countdowns to the Home Screen and Lock Screen. If widgets are part of your plans, add them to your mobile app project brief, or read about our iOS app development services.

Discuss widgets for your app