You tapped Install, the little circle spun a few times, and now your app is stuck with a grey icon that says 'Unable to Install.' Annoying, I know.
Here's the fix that works 9 times out of 10.
Step 1: Clear the stuck install
- Find the greyed-out app icon on your Home Screen.
- Press and hold it until the menu pops up.
- Tap Remove App, then Delete App. Don't tap 'Remove from Home Screen' — that just hides it and leaves the broken install behind.
- Open Settings > General > iPhone Storage. Scroll down. If you see the app listed with a tiny size like 0 KB or a few MB, tap it and delete it from there too.
After deleting, you should see the app vanish from the list within a second or two. If it lingers, force-quit Settings and check again.
Step 2: Check your storage
Still in Settings > General > iPhone Storage, look at the bar at the top. If you've got less than 1 GB free, iOS will quietly refuse to finish installs. It downloads the package, then bails when it can't unpack it.
Free up at least 2 GB. The fastest wins:
- Delete old videos in Photos. A single 4K clip can be 400 MB.
- Offload apps you rarely use. Offload keeps documents, removes the binary.
- Clear Safari cache: Settings > Safari > Clear History and Website Data.
Step 3: Reinstall from the App Store
- Open the App Store app.
- Tap your profile picture in the top right.
- Tap Purchased > My Purchases, find the app, tap the cloud icon.
You should see the cloud icon turn into a progress ring. If it spins for more than 30 seconds without progress, jump to Step 4.
Step 4: Sign out and back into your Apple ID
This clears a corrupted session token, which is the real culprit behind a lot of stuck installs.
- Open Settings.
- Tap your name at the top.
- Scroll to the bottom. Tap Sign Out.
- Enter your Apple ID password when prompted. Choose whether to keep or delete data on the phone — keeping is fine.
- Sign back in.
Give it 20 seconds, then try the install again.
Why this works
iOS treats an app install like a transaction. It checks storage, validates your Apple ID token, downloads a signed package, then unpacks it. If any one of those steps fails, you get the generic 'Unable to Install' message instead of a specific error. Deleting the partial download clears the corrupted package. Freeing storage gives iOS room to unpack. Re-signing refreshes the token that got stale — usually because you changed your Apple ID password on another device, or because you restored from a backup made under a different account.
If it's still failing
Error 403 or 'Cannot Connect to App Store'
Check Settings > General > Date & Time. If 'Set Automatically' is off, turn it on. iOS rejects App Store connections when the clock drifts more than a few minutes.
Family Sharing installs
Apps shared from a family member can fail if that person removed you from the group. Ask them to re-invite you under Settings > [Their Name] > Family Sharing. After accepting, wait 10 minutes — the change isn't instant on Apple's end.
MDM or work-managed devices
If this is a work iPhone, your IT admin might've blocked the app. You'll see a profile warning under Settings > General > VPN & Device Management. You can't override this yourself.
iOS 17.4 and older — known install hang
There's a bug where installs hang at 90% on Wi-Fi with a captive portal (hotel, airport, Starbucks). Toggle off Wi-Fi, use cellular for the download, then switch back.
TestFlight builds
If you're installing a beta, the build might've expired. Open TestFlight, pull down to refresh, and check the app's status. Expired builds can't be reinstalled — you need a new invite.
Nuclear option: reset network settings
Settings > General > Transfer or Reset iPhone > Reset > Reset Network Settings. This wipes saved Wi-Fi passwords, so have them handy. Use it only if nothing else worked.
Stopping it from happening again
- Keep at least 5 GB free. iOS needs headroom for updates and installs.
- Update iOS on Wi-Fi and while plugged in. Interrupted updates corrupt the install framework.
- Don't force-quit the App Store mid-download. Let it finish or cancel it cleanly from the app's page.
- If you use a VPN, turn it off during installs. Some VPNs route App Store traffic through servers Apple flags as suspicious.
That's it. Ninety percent of the time, deleting the broken icon and reinstalling does the job. The other 10% is storage, sign-in, or a network quirk you can now spot in seconds.