eSIM QR Code Not Working? 9 Fixes That Actually Work
Most "broken" eSIM QR codes are actually one of nine known problems, from single-use codes to the screenshot trap. Here's how to diagnose and fix each one, step by step.
Quick answer
An eSIM QR code that "doesn't work" almost always fails for one of nine specific, fixable reasons โ the code was already used once (most are single-use), you're trying to scan a QR displayed on the same phone you're installing it on (physically impossible), or you're scanning from the wrong place in your phone's software. Work through the fixes below in order: the first four resolve the vast majority of cases, and manual SM-DP+ entry (fix 6) works even when scanning is completely broken. If none of the nine work, the code itself is likely expired or corrupted, and only your provider can reissue it.
Why eSIM QR codes fail (and why it's rarely the code)
Before the fixes, it helps to understand what an eSIM QR code actually is. It's not the eSIM. The QR code is just a short text string โ an address pointing to your carrier's provisioning server (the SM-DP+ server) plus an activation code. When your phone reads it, it contacts that server over the internet and downloads the actual eSIM profile.
That architecture explains almost every failure mode:
- The download needs internet, so no Wi-Fi means no install.
- The server tracks each code, so most codes work exactly once.
- The phone doing the installing must read the code, so it can't scan its own screen.
- The profile installs to specific hardware, so a carrier-locked or incompatible phone gets rejected.
If your phone doesn't support eSIM at all, no QR code will ever work โ check our compatible devices list or run the quick eSIM compatibility checker before spending time on the fixes below. If you're new to the technology entirely, our explainer on what an eSIM is covers the basics.
Now, the nine fixes, ordered from most to least common.
Fix 1: Check whether the eSIM is already installed
This is one of the most common "broken QR code" reports, and there's nothing broken at all. If you scanned the code once โ even if the progress screen seemed to hang, or you backed out midway โ the profile may have installed successfully in the background. Scanning again then produces an error, because the code has been consumed (see fix 2).
Check on iPhone: open Settings > Cellular (called Mobile Service or Mobile Data in some regions and iOS versions). Look under the SIMs list. If you see a new line โ often labeled with the provider name, "Travel," "Secondary," or a generic label โ the eSIM is already there. Tap it to confirm it's turned on.
Check on Android: on a Pixel, open Settings > Network & internet > SIMs. On a Samsung, open Settings > Connections > SIM manager (newer One UI versions may show SIMs). Any downloaded eSIM appears in that list.
If the profile is installed, your problem isn't the QR code โ it's configuration. Make sure the eSIM line is enabled, data roaming is on for that line (travel eSIMs almost always require roaming enabled), and the correct line is selected for mobile data. "Installed but no service" is a different problem from "QR won't scan," and it usually resolves once you're physically in the destination country or after a restart.
Fix 2: Understand that most codes are single-use
eSIM QR codes are typically one-time use. The provisioning server marks the activation code as claimed the moment a device downloads the profile. If you:
- deleted the eSIM from your phone and try to rescan the same code,
- installed it on an old phone and want to move it to a new one, or
- scanned it on the wrong device by mistake,
the same QR code will usually return an error like "this code is no longer valid," "eSIM cannot be added," or a generic activation failure. That's the system working as designed, not a glitch.
What to do: contact your provider and ask for the profile to be reissued or transferred. Policies differ โ some providers will re-enable the same code, some issue a fresh one, and some treat an installed-then-deleted profile as consumed with no recourse. This is worth checking before you buy: as our methodology notes, refund and reissue terms sit outside our automated pricing pipeline, so verify the reinstallation policy on the provider's own site โ every seller we track is listed in our provider directory.
The practical rule: never delete a working travel eSIM until the trip is over and you're sure you won't need it again. Deleting is not like removing a physical SIM you can pop back in.
Fix 3: Escape the screenshot trap โ you can't scan a QR shown on the same phone
Here's the one that catches nearly every first-time eSIM buyer: your provider emails you a QR code, you open the email on the phone you want to install the eSIM on, and now you're stuck. A phone cannot point its camera at its own screen. Screenshotting the code and pointing the camera at the screenshot doesn't work either โ the scanner needs to see the code through the camera, and the code is trapped inside the very device that needs to scan it.
Four legitimate ways out:
- Display the QR code on another screen. Open the confirmation email on a laptop, tablet, second phone, or even a smart TV browser, then scan it with your phone. This is the universal solution and works on every device.
- Print it. A paper printout scans perfectly and doubles as a backup if you need to reinstall later (subject to the single-use caveat in fix 2).
- Install from the image directly (iPhone, iOS 17.4+). If the QR code arrives in Apple Mail or appears in Safari, touch and hold the QR code image, then tap Add eSIM in the menu that appears. No second screen needed. On iOS 17 and later you can also go to Settings > Cellular > Add eSIM > Use QR Code and choose Open Photos (where offered โ availability varies slightly by iOS version) to select a saved screenshot of the code โ the phone decodes the image file instead of using the camera.
- Use the manual activation details instead. Every QR code encodes text that can be typed by hand โ see fix 6.
Android's equivalent varies by manufacturer and version. Some Android builds can pick a QR image from the gallery during eSIM setup; many cannot. If yours can't, use a second screen or manual entry.
Fix 4: Scan from the right place โ camera app vs. settings scanner
There are two different ways phones read eSIM QR codes, and mixing them up causes real confusion.
The camera route (iPhone): open the normal Camera app and point it at the QR code. iOS recognizes it as an eSIM code and shows a Cellular Plan Detected notification โ tap that notification, then tap Continue and follow the prompts. If you scan with the Camera app and no notification appears, the code may be too small on screen, poorly lit, or not actually an eSIM code (some providers email a QR that just links to their app or website โ check what the email says the code is for).
The settings route (more reliable): skip the camera app entirely and launch the scanner from inside eSIM setup, where the phone is explicitly expecting an eSIM code:
- iPhone: Settings > Cellular (or Mobile Service) > Add eSIM > Use QR Code
- Google Pixel: Settings > Network & internet > SIMs > Add SIM, then tap Download a SIM instead?, and scan when prompted
- Samsung Galaxy: Settings > Connections > SIM manager > Add eSIM, then scan the QR code
If the camera-app route fails, always try the settings route before concluding the code is bad. The built-in eSIM scanner is more tolerant and gives more specific error messages.
Scanning hygiene matters too: increase the brightness of the screen displaying the code, enlarge the code to at least a few centimeters across, avoid glare, and hold the phone steady 15โ30 cm away. A crumpled printout or a code rendered tiny inside a PDF thumbnail is a common silent failure.
Fix 5: Connect to solid Wi-Fi before installing
Remember: scanning the QR only tells your phone where to download the eSIM. The download itself needs a working internet connection โ and if you're installing a travel eSIM precisely because you have no mobile data, Wi-Fi is your only option.
Common traps:
- Airport and hotel captive portals. Networks that require a login page can appear "connected" while blocking the provisioning download. Fully complete the portal login (open a browser page and confirm real internet access) before scanning.
- Installing at the gate with 2 minutes to boarding. A profile download interrupted midway can leave you in the worst state: code consumed, profile half-installed. Install your eSIM at home, on your own Wi-Fi, before you travel. Nearly every travel eSIM only starts its validity clock when it first connects to a supported network abroad โ installing early costs you nothing. Check the specific country page for your destination, for example eSIM plans for Japan, where activation policies are listed per plan.
- VPNs and private DNS. Occasionally these interfere with reaching the provisioning server. Temporarily disable them for the install.
If the install fails mid-download, restart the phone and try once more before assuming the code is dead โ Apple's own eSIM troubleshooting page lists a restart and a carrier settings update as first steps.
Fix 6: Enter the details manually (the SM-DP+ method)
This is the fix that works when scanning is impossible โ broken camera, unreadable code, single-phone situation on older iOS, or an Android build with no image-import option. Every eSIM QR code encodes a plain text string, and every eSIM-capable phone accepts that text typed by hand.
Your provider's confirmation email (or account dashboard) should list two values alongside the QR code:
| Field | What it looks like | What it does |
|---|---|---|
| SM-DP+ address | A web-style address, e.g. smdp.example.com | The provisioning server your phone contacts |
| Activation code | A long string of letters, numbers, and dashes | Identifies your specific eSIM profile |
| Confirmation code (sometimes) | A short PIN | Extra verification some carriers require |
Some providers instead give one combined string starting with LPA:1$ โ the part after the first dollar sign is the SM-DP+ address, and the part after the second is the activation code.
iPhone: Settings > Cellular > Add eSIM > Use QR Code, then tap Enter Details Manually at the bottom of the screen. Type the SM-DP+ address and activation code exactly as given.
Google Pixel: Settings > Network & internet > SIMs > Add SIM > Download a SIM instead?, then tap Need help? and choose the option to enter the code manually.
Samsung Galaxy: Settings > Connections > SIM manager > Add eSIM, then choose the option to enter an activation code instead of scanning.
Type carefully โ these strings are long, case-sensitive on some systems, and a single wrong character fails silently. Copy-paste from the email where possible. If your provider's email doesn't include manual details, their support team can read them out from your order; any reputable provider has them, since the QR is just these values in graphical form. Each provider profile in our provider directory also includes general setup notes for that seller's plans.
Fix 7: Rule out carrier lock
If your phone was bought from a mobile carrier โ especially on an installment plan โ it may be carrier-locked, meaning it refuses to install SIM profiles (physical or eSIM) from any other network. The error messages here are often misleading: the phone may simply say the plan "cannot be added," which sends people hunting for QR problems that don't exist.
Check on iPhone: Settings > General > About, scroll to Carrier Lock. It should say No SIM restrictions. Anything else means the phone is locked.
Check on Android: there's no universal indicator; the reliable test is whether a different carrier's SIM works, or a call to the carrier that sold you the phone.
The fix is an unlock request to the original carrier. Most carriers unlock phones for free once the device is paid off and any minimum term is met, but processing can take from minutes to several days โ another reason to test your eSIM setup before the trip, not in the arrivals hall. Note that carrier lock is separate from eSIM capability: a phone can support eSIM perfectly and still be locked. Our compatibility checker covers the hardware side; the lock status is between you and your carrier.
One more regional wrinkle: some phones sold in mainland China have no eSIM support at all even when the same model supports it elsewhere, and some other regional variants have limitations. If your phone was purchased abroad, verify your exact variant on the compatible devices list.
Fix 8: Restart, update, and retry โ the boring fixes that work
Unglamorous, but Apple and Google both list these first for a reason:
1. Restart the phone. Provisioning gets stuck; a reboot clears it more often than seems reasonable. 2. Update the OS. eSIM handling has improved materially across releases (the iOS 17+ photo-install options in fix 3 are one example). An old OS version can fail on codes a current one handles fine. 3. Install carrier settings updates (iPhone: if a prompt appears under Settings > General > About, accept it). 4. Wait and retry. Provisioning servers have outages like any other service. If the error is a server-side one ("unable to complete," timeouts), trying again in 30โ60 minutes genuinely resolves some cases. 5. Free up a slot. Phones support a limited number of active eSIMs (commonly two lines active simultaneously on recent iPhones, with more stored). If you've accumulated old travel profiles, an install can fail or behave oddly โ disable unused profiles rather than deleting ones you might reuse.
Apple's official eSIM setup guide is worth bookmarking for iPhone-specific steps; it stays current as menu names shift between iOS versions.
Fix 9: Expired codes โ and when to stop troubleshooting and contact the provider
eSIM activation codes don't live forever. Many providers require the profile to be installed within a set window after purchase โ commonly 30 to 180 days, sometimes less โ and separately, plans themselves can have a "start by" date. If you bought an eSIM months ago for a postponed trip, the code may simply have expired server-side. No amount of scanning technique fixes that.
Contact your provider when:
- the code returns "invalid," "expired," or "already used" and fixes 1โ2 don't explain it,
- manual entry (fix 6) fails with the same error as scanning โ that confirms the problem is the code or the server, not your phone,
- the install completes but the plan never activates on arrival, or
- you need the profile reissued for a new phone.
Good providers resolve these quickly โ reissuing a profile is trivial on their side. Slow or unreachable support during an activation failure is exactly the scenario that separates good eSIM sellers from bad ones, and it's worth remembering when you choose who to buy from next time. And since you may end up buying a replacement plan on the spot, it's worth comparing current prices for your destination across all countries โ or, if you're covering several countries in one trip, using the multi-country search to find one plan that covers the whole route. Before checkout, check the current coupon codes; a reissued plan shouldn't cost you more than the first one did.
If you'd rather describe the problem in plain language and get pointed to the right plan or fix, our AI travel eSIM advisor is grounded in the same plan database as the rest of the site.
Symptom-to-fix quick reference
| Symptom | Most likely cause | Go to |
|---|---|---|
| Camera sees the code, nothing happens | Wrong scanning route, or not an eSIM code | Fix 4 |
| "Code already used" / "no longer valid" | Single-use code consumed (or already installed) | Fixes 1โ2 |
| QR is on the same phone | Screenshot trap | Fix 3 |
| Install starts, then fails midway | No real internet / captive portal | Fix 5 |
| Camera can't scan at all | Use manual SM-DP+ entry | Fix 6 |
| "Plan cannot be added" on a carrier-bought phone | Carrier lock | Fix 7 |
| Fails with no clear error | Restart, update, retry | Fix 8 |
| Old purchase, everything fails | Expired code โ contact provider | Fix 9 |
FAQ
Can I scan an eSIM QR code with my phone's normal camera app?
On iPhone, yes โ the Camera app recognizes eSIM codes and shows a Cellular Plan Detected notification you tap to continue. On most Android phones, the camera app alone won't handle it; you need to start from the eSIM setup screen (Settings > Network & internet > SIMs on Pixel, Settings > Connections > SIM manager on Samsung) and use the scanner it launches. When in doubt on either platform, the settings route is the reliable one.
Can I reuse an eSIM QR code on a new phone?
Usually not directly. Most codes are single-use: once any device downloads the profile, the code is consumed. Moving an eSIM to a new phone normally means asking the provider to reissue or transfer the profile. Policies vary widely between providers, so check the reinstallation policy before you buy if you switch phones often.
What are the SM-DP+ address and activation code?
They're the two pieces of information hidden inside every eSIM QR code: the SM-DP+ address is the carrier server your phone downloads the profile from, and the activation code identifies your specific eSIM on that server. Every eSIM-capable phone lets you type them in manually โ on iPhone via Enter Details Manually on the QR scan screen โ which makes manual entry the universal fallback when scanning fails.
The eSIM installed but I have no service. Is the QR code the problem?
No โ once the profile appears in your SIM list, the QR code did its job. "No service" after installation is a settings or coverage issue: make sure the eSIM line is turned on, data roaming is enabled for that line, and it's selected as your mobile data line. Many travel eSIMs also only connect once you're physically in a covered country. If you're still stuck on arrival, restart the phone and toggle airplane mode before contacting support.
Do I need internet to install an eSIM?
Yes. The QR code only points your phone at the download; the eSIM profile itself comes over the internet, which is why a Wi-Fi connection is effectively required when installing a travel eSIM (you typically don't have working mobile data at that moment). Install at home before departure whenever possible โ most travel plans don't start counting validity until they first connect abroad.
How do I know if my phone supports eSIM at all?
Roughly, iPhones from the XS/XR (2018) onward, Google Pixels from the Pixel 3 onward, and most Samsung flagships from the Galaxy S20 onward support eSIM โ but regional variants complicate this, and some phones sold in China lack eSIM entirely. Check your exact model on our compatible devices list or use the compatibility checker tool, which also shows the on-device test you can run in 30 seconds.