How do I fix "Unable to install eSIM" on an iPhone with AT&T?
Answer
First check Settings > General > About for Carrier Lock. If the phone is unlocked or approved for AT&T, add the eSIM again using AT&T’s QR code, app, or manual activation—not a generic iPhone suggestion—after AT&T confirms the line is ready.
Before you start: stop right away if…
- Deleting an existing working eSIM can interrupt service; remove plans only when you intend to replace them.
- Use only AT&T’s official app, QR code, or account tools—not random unlock or eSIM websites.
Follow these steps
Check Carrier Lock status
Go to Settings > General > About and look at Carrier Lock. If it says the phone is locked to another carrier, contact that carrier for an unlock before trying AT&T again.
You should see: You know whether the iPhone is unlocked or still locked to a different network.
Confirm the AT&T line is ready
Sign in to AT&T’s official account tools or contact AT&T and confirm the line is fully activated for this iPhone’s IMEI before another install attempt.
You should see: AT&T confirms the number is provisioned and ready for eSIM install.
Add eSIM with AT&T’s method
Open Settings > Cellular > Add eSIM and use the activation method AT&T provides—QR code, carrier activation, AT&T app, or manual entry. Do not rely on a generic iPhone cellular suggestion if AT&T gave a specific method.
You should see: The eSIM begins installing with AT&T’s plan details.
Restart and verify the line
If install completes, restart the iPhone, then check Settings > Cellular for the AT&T plan and test a call or data connection.
You should see: The AT&T eSIM appears and network service works.
Retry once after a failed install
If it fails again with the same error, remove only the failed incomplete plan if Apple shows that option, wait a few minutes, and repeat AT&T’s activation method once more. Escalate to AT&T with the exact error text if it still fails.
You should see: Either the eSIM installs, or AT&T has the error details needed to fix provisioning.
Not sure this is the right page? Check here
0 of 5 checked
Extra tips
What to look for: The message "Unable to install eSIM," wording about not supported or contact carrier, and the Carrier Lock value under Settings > General > About.
Before you change anything: Have the AT&T account ready and any QR code or activation details AT&T provided. Connect to Wi‑Fi before adding an eSIM. Write down the iPhone IMEI from Settings > General > About. Avoid deleting a working eSIM until the new one is confirmed.