If your iPhone is not detecting eSIM, the problem is usually caused by one of a few common issues: unsupported model, carrier lock, incomplete setup, network problems, or a software/settings glitch.
This can happen in different ways. Some users do not see the Add eSIM option at all. Others scan a QR code and nothing happens. Some see an error like Cannot Add eSIM, while others install a profile but the iPhone still does not recognize it properly.
The good news is that most eSIM detection problems are fixable without buying a new plan.
This guide explains exactly why your iPhone is not detecting eSIM and how to fix it step by step.
Quick answer: First check whether your iPhone model supports eSIM, make sure it is carrier-unlocked, update iOS, connect to strong Wi-Fi, and retry setup. Those steps solve many iPhone eSIM detection issues.
1. Your iPhone model may not support eSIM
This is the first thing to check.
Not every iPhone supports eSIM, and some region-specific models have different SIM capabilities.
If the iPhone itself does not support eSIM, it may:
- show no Add eSIM option
- ignore eSIM setup attempts
- never detect the profile correctly
Helpful reading: iPhone eSIM Support
2. Your iPhone may be carrier locked
Even if the phone supports eSIM technically, a carrier lock can still block you from adding third-party eSIM plans.
This is very common with phones purchased through certain operators.
What to check:
- Go to Settings
- Tap General
- Tap About
- Find Carrier Lock
If it does not say No SIM restrictions, that may be the reason your iPhone is not detecting or accepting the eSIM.
3. iOS may be outdated
Older iOS versions sometimes create eSIM setup issues, especially after carrier setting changes or newer plan formats.
Fix:
- Go to Settings
- Tap General
- Tap Software Update
- Install the latest iOS version
Then restart the iPhone and try again.
4. The iPhone has no stable internet during setup
Many people forget this part: adding an eSIM usually requires a stable internet connection.
If Wi-Fi is weak, airport Wi-Fi is unstable, or VPN is interfering, your iPhone may fail to detect or add the eSIM properly.
Fix:
- Connect to strong Wi-Fi
- Disable VPN temporarily
- Retry setup
5. The QR code is being scanned incorrectly
If your iPhone is not detecting the eSIM while scanning, the issue may not be the eSIM itself — it may be the QR setup process.
Common problems:
- trying to scan the QR code from the same iPhone screen
- blurry camera focus
- dim screen brightness on the device showing the QR
- already-used QR code
Fix:
- Open the QR code on another device
- Increase brightness
- Clean the camera lens
- Retry using strong lighting
Helpful reading: Why Is My eSIM QR Code Not Working?
6. The iPhone may need manual eSIM setup instead
Some eSIMs can be added with manual details instead of QR scan.
If your iPhone does not detect the QR correctly, manual activation may still work.
Look for provider details such as:
- SM-DP+ address
- activation code
- confirmation code
Helpful reading: Why Is My eSIM Asking For Activation Code?
7. The eSIM profile may already be installed but hidden
Sometimes users think the iPhone is not detecting the eSIM, but the profile is actually already installed and just not obvious.
This can happen if:
- the line was turned off
- it was renamed
- it appears lower in Cellular settings
Fix:
- Go to Settings
- Tap Cellular
- Check all listed lines carefully
Helpful reading: Why Is My eSIM Installed But Hidden?
8. A previous failed install may be blocking the retry
If an earlier setup attempt failed halfway, iPhone may behave strangely on the next attempt.
Fix:
- Restart iPhone
- Reconnect to Wi-Fi
- Retry setup once cleanly
Do not repeatedly scan the QR code too many times unless the provider confirms it supports multiple attempts.
9. The provider code may be expired or single-use
If the QR code or activation details were already used once, your iPhone may appear to “not detect” the eSIM even though the real issue is that the activation credential is no longer valid.
Fix:
- Check your provider email
- Check whether the code was already used
- Contact support if needed
10. Carrier settings may need refresh
Sometimes iPhone carrier settings need a refresh before network-related features behave correctly.
Fix:
- Go to Settings
- Tap General
- Tap About
- Wait a few seconds in case a carrier update prompt appears
How to add eSIM on iPhone correctly
- Open Settings
- Tap Cellular
- Tap Add eSIM
- Choose Use QR Code or Enter Details Manually
- Follow the prompts
If you do not see Add eSIM, that usually points to model support, lock status, or settings limitations.
Fast 60-second checklist
- Check iPhone supports eSIM
- Check carrier lock status
- Update iOS
- Use strong Wi-Fi
- Disable VPN
- Retry with QR on another screen
- Check if the eSIM is already installed
What errors often mean
No “Add eSIM” option
Usually unsupported model, restrictions, or settings issue.
Cannot Add eSIM
Could be carrier lock, bad QR, expired code, or connectivity problem.
QR scanned but nothing happens
Usually internet, iOS, or provider credential issue.
eSIM appears once, then disappears
Often hidden line, incomplete activation, or software refresh issue.
Common traveler mistakes
Trying setup on weak airport Wi-Fi
Unstable internet causes many install problems.
Not checking carrier lock first
This can waste a lot of time.
Thinking every iPhone supports eSIM
Model and region matter.
Scanning the QR code from the same iPhone
The camera cannot scan its own screen.
When to contact support
Contact support if:
- your iPhone supports eSIM and is unlocked
- you updated iOS and used strong Wi-Fi
- QR and manual setup both fail
- you suspect the activation code is invalid
Helpful page: Contact Support
Final thoughts
If your iPhone is not detecting eSIM, the problem is usually not permanent. In most cases, it comes down to device support, carrier lock, internet quality, or installation method.
Start with the basics: supported iPhone, unlocked device, updated iOS, strong Wi-Fi, and correct setup path. Those steps solve a large share of iPhone eSIM problems quickly.
Need a travel plan with simple setup? Browse travel eSIM plans and choose one that fits your destination.
FAQ
Why does my iPhone not show Add eSIM?
Usually because of unsupported model, restrictions, or carrier lock issues.
Can a locked iPhone block eSIM?
Yes. Carrier-locked iPhones may reject third-party eSIMs.
Do I need Wi-Fi to add eSIM on iPhone?
Usually yes, or another stable internet connection during setup.
Can I install eSIM manually on iPhone?
Yes. Many plans support manual activation details if QR scanning fails.
Should I delete and retry immediately?
Not usually. Check support, lock status, internet, and setup method first.