iPhone widget blank, gray or showing a placeholder
Apple’s WidgetKit documentation says the system shows a placeholder, a generic version of the widget with no real content, the first time a widget is displayed, while data loads, and on a locked device until you unlock it after a restart. Unlock the iPhone, open the widget’s app once, then restart the phone if the placeholder stays.
Last reviewed: 20 November 2026.
When iOS shows a placeholder
From Apple’s developer documentation:
- “When WidgetKit displays your widget for the first time, it renders the widget’s view as a placeholder.”
- “WidgetKit may need to render your content as a placeholder, for example, while you load data in the background or if you tell the system that your widget contains sensitive information.”
- “WidgetKit uses its default behavior and displays a placeholder until a person authenticates after they reboot their device.”
- Apps can mark widget content as sensitive; then “until a person unlocks their device to match the privacy level you chose, WidgetKit displays a placeholder instead of the widget content.”
A gray or empty widget is often one of these states, not a broken app.
Steps to try, in order
- Unlock the iPhone with Face ID, Touch ID or your passcode. After a restart, Apple says widgets show a placeholder until you authenticate.
- Open the widget’s app and finish any setup it asks for, then return to the Home Screen.
- If the widget is on the Lock Screen, check Settings > Face ID & Passcode. Apple says the Allow Access When Locked section is where data access for Lock Screen widgets can be turned off.
- Restart the iPhone.
- Check free space in Settings > General > iPhone Storage.
- Update the app and iOS, then remove the widget and add it again.
If only the Lock Screen copy is blank
Apple notes that widgets “can be highly visible, especially on devices with an Always-On display,” and that apps can mark content as privacy sensitive so it is hidden while the phone is locked. In that case the Home Screen copy shows content once you unlock, while the Lock Screen copy shows a placeholder until then. See Lock Screen widget hidden until unlocked.
Ember’s widget before setup
Ember’s widget has nothing to show until someone has been added in the app: a name, who they were to you, the day they died, and optionally a photo and birthday. If you added the widget first, open Ember, finish setup, then go back to the Home Screen. With more than one person, touch and hold the widget, tap Edit Widget and choose who it shows. See setting up Ember and choosing who a widget shows.
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
Is a placeholder the same as the preview in the widget gallery?
No. Apple describes the gallery preview as example data showing what the widget displays, and the placeholder as a generic shape with no specific content.
Could low storage cause a blank widget?
Apple does not document that directly. Checking storage is a general step; Apple says a full iPhone frees space on its own by removing items it can download again.
Sources
- Apple Developer: placeholder(in:) (WidgetKit)
- Apple Developer: Creating a widget extension (WidgetKit)
- Apple iPhone User Guide: Add, edit, and remove widgets on iPhone
- Apple Support: Restart your iPhone
- Apple Support: How to check the storage on your iPhone and iPad
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.