An app’s widget is missing from the iPhone widget gallery
Apple’s WidgetKit documentation says that for an app’s widget to appear in the widget gallery, you must open the app at least once after installing it. Open the app, go back to the Home Screen, touch and hold the background, tap Edit, then tap Add Widget and search for the app’s name.
Last reviewed: 20 November 2026.
Add the widget once the app has been opened
- Open the app from the Home Screen or App Library, then return to the Home Screen.
- Touch and hold the Home Screen background until the apps jiggle.
- Tap the Edit button, then tap Add Widget.
- Search for the app or scroll the list, tap it, then swipe through the sizes and styles.
- Tap Add Widget, move it where you want it, then tap Done.
Apple’s developer documentation states the requirement directly: “For an app’s widget to appear in the widget gallery, a person must launch the app that contains the widget at least once after the app is installed.”
If it still does not appear
- The app is offloaded. An offloaded app keeps its icon on the Home Screen with a cloud symbol; tap it to reinstall, then open it.
- The app is hidden. Hidden apps move to the Hidden folder at the bottom of App Library. Settings > Apps > Hidden Apps lists them.
- A Screen Time limit blocks the app. Check Settings > Screen Time.
- The app or iOS is out of date. Update both, then restart the iPhone and look again.
- You are looking at the wrong place. Lock Screen widgets are added from the Lock Screen (touch and hold it, tap Customize, then tap Add Widgets), not from the Home Screen gallery.
Finding Ember in the gallery
After installing Ember, open it once. Its small Home Screen widget is free; the medium Home Screen widget and the three Lock Screen shapes are part of Ember — Forever. Lock Screen widgets appear in the Lock Screen’s Add Widgets list, not in the Home Screen gallery. See Ember’s Home Screen widgets and Ember’s Lock Screen widgets.
Ember is free to download for iPhone (iOS 17 or later): one person, one photo, the small Home Screen widget and an alert for the next milestone. Ember — Forever is a one-time $9.99 purchase in the United States, not a subscription, and adds every person, up to twenty photos each, the medium and Lock Screen widgets, all four themes and an alert for every milestone.
Questions
Do I need to keep the app open?
No. Apple’s requirement is that the app has been launched at least once after it was installed.
I reinstalled the app. Do I need to open it again?
Apple’s wording is “at least once after the app is installed,” so open it after each install.
Can every app add a widget?
No. Only apps that include a widget extension appear in the gallery.
Sources
- Apple Developer: Creating a widget extension (WidgetKit)
- Apple iPhone User Guide: Add, edit, and remove widgets on iPhone
- Apple iPhone User Guide: Manage storage on iPhone
- Apple iPhone User Guide: Lock or hide an app on iPhone
- Apple Support: How to add and edit widgets on your iPhone
Apple, iPhone, iOS, iCloud and other product and company names are trademarks of their respective owners. They are used here only to describe compatibility and how their products work. Ember is not affiliated with or endorsed by them.