eSIM QR Code Not Working? The Best Quick Fix

If your eSIM QR code is not working, eSIM troubleshooting is short: the cause is almost always one of four things: you are trying to scan the code from the screen of the same phone you are installing on, the image is too small or too dark to read, your phone has no internet connection, or the code has already been used once. Each of those has a fix, and none of them requires technical knowledge.

Quick answer: work through the eSIM troubleshooting fixes below in order. Most eSIM QR code problems are solved in the first two steps, and anything left over can be handled with manual eSIM activation using the activation code and SM-DP+ address supplied with your plan.

Before the eSIM troubleshooting, the basics: an eSIM (embedded SIM) is a digital SIM profile downloaded onto a chip already inside your phone. The QR code (Quick Response code) is just a container for the download instructions — so when scanning fails, the profile itself is usually fine.

Browse Atlas eSIM plans for your destination.

Where the claims on this page come from

eSIM activation failure is a subject with a great deal of confident writing behind it and not much sourcing, so here is what this page rests on and where it stops.

• The fixes below are ordered by how often each cause turns out to be the real one in the activation problems we see, not by how technical they sound. The first three resolve the large majority, and the most common single cause is the least technical: trying to scan a code displayed on the same phone that is doing the scanning.
• Platform behaviour comes from how iOS and Android actually implement profile download, which differs in wording between versions and manufacturers. Where a menu path varies by model we say so rather than pretending there is one universal route.
• The activation code and SM-DP+ address are a standard format defined by the GSMA, which is why manual entry works identically across providers and handsets. If a provider's QR code will not scan, its manual details will still work — the code is only a delivery mechanism.
• Timing is weighted above every individual fix. Nearly every problem on this page is a five-minute inconvenience at your kitchen table and a genuine crisis in an arrivals hall, because most of the fixes need an internet connection you do not have yet. If you take one thing from this page, install before you fly.
• We name competitors and never publish their prices. Travel data pricing changes weekly and a figure printed here would be wrong within the month. You get the shape of each option and an instruction to check the live number.
• Where something depends on your specific handset, operator or country, we say so rather than generalising. Most bad advice on this topic is a true statement about one phone applied to all of them.

Last checked: September 2026.

eSIM troubleshooting starts with the error message

Different phones word the same eSIM QR code not working problem differently. Match what you see on screen to the likely cause before you start changing settings.

Fix 1: Why a QR code scan failed on the same phone

Symptom: you open the camera in your eSIM settings and nothing happens, because the QR code is sitting in an email or a screenshot on that very phone.

Cause: a QR code scan failed here for a physical reason. The phone needs to point its camera at the code. It cannot photograph its own screen.

Action: the eSIM QR code not working on one screen works on two. Display the code somewhere else — a laptop, a tablet, a printout, or a partner's phone — then scan it. Open the confirmation email on a computer and scan from that screen. If you have no second screen available, skip straight to Fix 6 and enter the details by hand; the result is identical.

Fix 2: The eSIM QR code not working because it is unreadable

Symptom: the camera focuses on the code but the phone never recognises it.

Cause: a QR code scan failed almost always means the image is hard to read. QR codes need contrast, sharpness and margins. A screenshot cropped too tightly, a photo taken at an angle, a dimmed screen or a dark-mode email can all break the scan.

Action:

1. Open the original email or PDF rather than a forwarded screenshot.
2. Turn the displaying screen's brightness to maximum and switch off any dark or night mode.
3. Zoom so the code fills roughly a third of the screen, leaving white space around all four edges.
4. Hold the scanning phone 15–25 cm away, square on, and wait two seconds for focus.
5. Wipe the camera lens — a smudged lens defeats more scans than people expect.

If the QR code scan failed on paper, avoid glossy lighting and glare. A slightly angled printout under a lamp often scans when a flat one does not.

Fix 3: You are scanning in the wrong app

Symptom: the camera app recognises the code and offers to open a web link, or does nothing useful at all.

Cause: this is the most common eSIM QR code not working report we get. An eSIM profile must be installed through your phone's mobile settings, not a generic QR reader.

Action: use the correct path for your device. Menu names shift slightly between versions, so look for the nearest match.

• iPhone: Settings → Mobile Service (or Cellular) → Add eSIM → Use QR Code.
• Google Pixel: Settings → Network & internet → SIMs → tap the + or "Add eSIM" → Download a SIM instead?
• Samsung Galaxy: Settings → Connections → SIM manager → Add eSIM → Scan QR code from service provider.

If you are unsure where these live on your model, our step-by-step eSIM installation walkthrough covers each platform in order.

Fix 4: Manual eSIM activation will not help without internet

Symptom: the code scans, then you get "Unable to add mobile plan", "Could not complete download" or a spinner that never finishes.

Cause: eSIM troubleshooting goes wrong here because scanning the code only tells your phone where to fetch the profile. The download itself needs an active internet connection — and if you are installing abroad with roaming off, you may have none.

Action:

1. Connect to a stable Wi-Fi network. Hotel and airport Wi-Fi with a captive login page often blocks the download; a home or café network is more reliable.
2. Turn Aeroplane Mode on for ten seconds, then off, and try again.
3. Switch off any VPN (Virtual Private Network) or private relay feature.
4. Restart the phone and retry once. A stalled download frequently clears after a reboot.

Avoid the whole problem: install your eSIM while you are still on trusted Wi-Fi at home, a day or two before departure. The profile sits dormant until you switch it on, and you avoid troubleshooting a download over airport Wi-Fi with a boarding gate closing.

Get your travel eSIM Instant activation in 160+ destinations, delivered by QR code.

Find an eSIM for your destination.

When the profile installs but there is still no data

A separate category of eSIM troubleshooting, and the one that produces the most frustrated support messages, because the hard part appeared to succeed. The profile is listed in your settings and nothing works. Run these in order.

The line is installed but switched off. Adding a profile does not always enable it. Open your mobile or SIM settings, find the travel line, and check it is turned on. On iOS this is a per-line toggle; on Android it is usually a SIM entry that can be enabled or disabled independently.

Data roaming is off for that line. This catches almost everyone, because it is counter-intuitive: a travel plan works by roaming onto a local network, so it needs data roaming enabled on the travel line specifically. Leave it off for your home line, which is what stops the unexpected bill, and on for the travel line, which is what makes it work.

The wrong line is set as the data line. Both lines are active, the travel plan is enabled, and the phone is still routing data through your home SIM. This is one setting on both platforms — mobile data source, or preferred data SIM — and it is worth checking after any restart.

You have not arrived yet. A travel plan usually cannot connect until you are physically inside its coverage area, because there is no network for it to roam onto at home. Seeing "no service" on the travel line the night before departure is normal and not a fault. The profile being installed is what you are confirming before you fly, not a live connection.

The APN is missing. Rare, but it happens on some Android builds. If the line registers on a network and shows signal yet nothing loads, check whether the provider publishes an APN and enter it manually in the line's settings.

The phone has latched onto a network the plan does not use. Set network selection to automatic, or if it is already automatic, choose manual and pick a different operator from the list. A flight-mode cycle, or a restart, resolves a surprising proportion of these.

You crossed a border. On a regional plan, moving between countries occasionally needs a nudge — flight mode on and off, or a manual network reselect. Knowing this is normal rather than a failure is worth more than any individual setting.

Fix 5: The eSIM QR already used error, explained

Symptom: the eSIM QR already used wording varies, but the phone reports that the code is invalid, expired, or has already been activated.

Cause: the eSIM QR already used message is literal. An eSIM QR code is single-use by design. Once the profile has been downloaded to a device, the code is spent — even if you later deleted the profile, and even if the download appeared to fail halfway through.

Action:

1. Check whether the profile is already installed. On iPhone: Settings → Mobile Service, and look for a second plan listed under your primary line. On Android: Settings → Network & internet → SIMs. If it is there, you do not need the code at all — just enable the line and switch on data roaming for it.
2. If you deleted the profile by mistake, stop trying the same code. Contact your provider's support and ask for a reissued eSIM activation code. Most providers can regenerate one, though some charge for reinstallation.
3. If you installed it on a different phone earlier — an old handset, a partner's device — remove it there first, then request the new code.

The practical eSIM troubleshooting lesson: never delete an eSIM profile to "start fresh". Deleting is permanent and takes the code with it. If a plan is misbehaving after installation, work through connection problems after an eSIM is installed before removing anything.

Fix 6: Manual eSIM activation, step by step, by hand

Symptom: everything above has failed, or you simply have no second screen to scan from.

Cause: none — manual eSIM activation is a fully supported alternative, not a workaround. The QR code contains exactly this information in machine-readable form.

For manual eSIM activation, your confirmation email should list an SM-DP+ address (a server address, something like rsp.example-provider.com) and an activation code (a long string of letters and numbers). Some plans also include a short confirmation code.

On iPhone:

1. Settings → Mobile Service → Add eSIM.
2. Tap Use QR Code, then Enter Details Manually at the bottom.
3. Paste the SM-DP+ address and the activation code exactly as supplied.
4. Tap Next and wait for the profile to download.

On Android (Pixel and most others):

1. Settings → Network & internet → SIMs → Add eSIM.
2. Tap Download a SIM instead? then Need help? → Enter it manually.
3. Enter the activation code string, which may begin with LPA:1$.
4. Confirm and wait.

In manual eSIM activation, copy and paste rather than typing. A single mistaken character — a capital I read as a lowercase l, or a trailing space — will fail silently and look like a broken code.

Fix 7: When the phone, not the code, is the problem

Symptom: there is no "Add eSIM" option anywhere in Settings, or the option is greyed out.

Cause: this is where eSIM troubleshooting stops being about the code. Either your handset does not support eSIM, it is locked to a carrier, or a work-managed device profile blocks new mobile plans.

Action: this is the end of eSIM troubleshooting and the start of a device question. Confirm your exact model supports eSIM — most flagship phones from 2018 onward do, but regional variants differ, and some models sold in mainland China ship without eSIM hardware. Check the device compatibility list or your manufacturer's documentation on Apple's official support site. The GSMA, the industry body behind the standard, also maintains background material at gsma.com.

If the QR code scan failed because the handset is carrier-locked, ask your home network to unlock it — they are usually obliged to once a contract or device payment is complete. On a company phone, your IT administrator may need to permit additional mobile plans; our notes on connectivity for business travellers cover the usual restrictions.

The device problems no fix on this page solves

Everything above assumes the handset can accept a profile at all. Three situations mean it cannot, and all three are worth checking before you buy rather than after.

The phone is carrier-locked. A handset bought on a contract or on instalments may refuse any profile other than its own operator's, and the error message rarely says so. Unlocking goes through the operator that sold it, usually requires the contract to be paid off, and can take a day or more. This is the single most common reason a QR code scan failed report turns out not to be about the code at all, and it is the one you absolutely cannot solve at an airport.

The model variant does not support eSIM. This is the trap that catches people who bought a phone abroad. eSIM support is decided by the regional model number rather than by the phone's name: several manufacturers ship variants for particular markets with the feature removed or replaced by a second physical tray. Mainland Chinese iPhone variants are the best known case, and there are others. Look up your exact model number — not the marketing name — in the manufacturer's own specification, and do it before buying a plan.

The device is managed by an employer. A phone enrolled in corporate device management may have profile installation blocked by policy, and the option will simply not appear in settings or will be greyed out. Nothing you do on the handset changes this. Ask your IT team, ideally more than a day before you travel, because the answer sometimes involves a policy change rather than a toggle.

What to send support if you are still stuck. Four things, and having them ready turns a three-message exchange into one: your exact model number and operating system version, the exact wording of the error on screen, whether the line appears in settings at all, and whether you have tried manual activation with the SM-DP+ address and code. A provider can diagnose almost anything from those four, and can usually tell within minutes whether the profile needs reissuing.

Do all of this at home. Every fix on this page is easier on your own wifi, with a laptop to display the code, time to look up a model number and a support desk in your own time zone. The profile stays dormant until you reach your destination, so installing a week early costs nothing and removes the entire category of problem.

eSIM troubleshooting checklist before you contact support

Run through this eSIM troubleshooting list first. It resolves most cases, and if it does not, you will have everything support needs.

• Phone confirmed eSIM-capable and unlocked
• Connected to stable Wi-Fi, VPN switched off
• Code displayed on a second screen at full brightness
• Scanned from Settings, not the camera app
• Phone restarted and retried once
• Manual activation attempted with copied-and-pasted details
• Existing eSIM list checked for an already-installed profile
• Exact error message screenshotted

Explore Atlas eSIM plans before your next trip.

eSIM troubleshooting: frequently asked questions

Ready to stay connected? Choose your destination.