Travel guide
eSIM QR Code Won't Scan? Here's Why and What to Do Instead
Noa Regev7 min read
The camera just won't "catch" the squares, you've tried five times already, and every second of delay before the phone works feels endless. The good news: if the QR code won't scan after a few attempts, don't delete anything and don't request a new eSIM. In most cases the problem is technical and fixable: brighten the screen displaying the code, adjust your distance from the camera so it can focus, and try again in even lighting without glare. If that still doesn't work, you have a built-in backup: manual installation, meaning you enter the SM-DP+ server address and the activation code directly into your phone's settings, without scanning anything. This isn't a workaround or a trick; it's an official installation method that exists exactly for this situation.
Key Takeaways
- Glare and low screen brightness on the device displaying the code are the most common causes of a failed scan.
- A QR code that's already been used once (on another device, or even the same device) won't work again on a second scan. eSIMs are generally single-use.
- Don't delete and reinstall as a first step. eSIM QR codes aren't always reissuable by the provider, and deleting an existing profile could leave you without an eSIM at all.
- Manual installation works exactly like scanning; it just requires copying two text fields instead of scanning an image.
- An internet connection is required during installation itself, whether you scan or enter details manually, even if you'll switch to the cellular network afterward.
Common Causes
The most common cause of a failed scan is lighting. If the QR code is displayed on a computer screen, a tablet, or an email opened on another phone, glare on the screen can hide some of the black-and-white squares the camera needs to read. A simple fix: tilt the screen showing the code, turn off strong overhead lighting, or move to a dimmer room.
Low screen brightness on the device displaying the code causes a similar problem. If you're showing the code from an email on one phone and trying to scan it with a second phone, make sure the source screen's brightness is turned all the way up before you try.
Wrong distance or focus produces the same result. The phone's camera needs a reasonable distance to focus on the code; not too close to the screen and not too far away. If the camera keeps "jumping" and won't lock focus, back off a bit and give it a second or two to focus before moving again.
The fourth cause is different from the first three: a QR code that's already been used. With most providers, each eSIM QR code is valid for one-time use. If you've already scanned it successfully once (even if installation failed partway through), or tried installing it on another device before, the code may simply stop working, even if the camera reads it perfectly fine technically. In that case, the problem isn't the scan quality, it's that the code has already been "consumed." If this is your first time going through installation at all, it's worth checking our iPhone installation guide or Android installation guide to make sure you haven't skipped a step.
Manual Installation as a Fallback
If you've tried several times under different lighting conditions and the scan still fails, go straight to manual installation. This isn't a temporary or less reliable fix: the GSMA eSIM specification, the industry body that sets the global eSIM standard, explicitly defines two equally valid activation methods: downloading a profile by scanning a QR code, or entering the same details manually. There's no difference in the final result between the two.
What you enter manually are two fields:
- SM-DP+ server address: the address of the server your phone downloads the eSIM profile from.
- Activation code: sometimes also called a confirmation code, the unique string tied to your order.
Both of these details come in the same email or on the same screen where you received your QR code, usually as text underneath the code image itself.
QR scan: point the camera at the code. Requires internet during installation. Result: eSIM profile installed. This is the default method.
Manual entry: copy two text fields. Requires internet during installation. Result: same eSIM profile installed. Use it when scanning keeps failing.
On iPhone: Go to Settings > Cellular (or Mobile Data) > Add eSIM, then look for an option called "Enter Details Manually." That's where you paste the server address and activation code into two separate fields. Apple documents this path as part of the standard installation process (Apple Support).
On Android: Go to Settings > Network & Internet > SIMs, tap to add a SIM, and choose "Add using activation code" or "QR unavailable." From there you can enter the details manually. The exact path in the settings menus varies slightly between manufacturers, but the manual entry option exists on every Android device that supports eSIM (Google Pixel Phone Help).
Why You Shouldn't Delete and Reinstall First
The natural reaction when something doesn't work is to delete it and start over. With eSIM, that's riskier than it looks. The eSIM profile and the QR code that comes with it are usually single-use and issued specifically for you by the provider. If you delete an installed eSIM profile, or cancel an installation midway, there's no guarantee the provider can simply reissue the same QR code automatically.
The practical consequence: if you delete before trying manual installation, you could end up without an active eSIM and without an immediate way to get a new one, especially if this happens at an inconvenient time or while you're traveling.
So the right order of operations is: first try scanning again under different lighting conditions, then try manual installation, and only if neither of those works, contact your provider's support team and ask for help or a new code. Deleting and reinstalling should be a last resort, used only after support confirms a new, valid code is available.
iPhone-Specific Notes
On iPhone, scanning an eSIM QR code is usually done directly through the Cellular menu in Settings (not through the regular Camera app), by tapping Add eSIM. Some devices also support scanning through the Camera app if the code arrives as an image in a text message or email, but the recommended path is always going directly through Settings.
If the screen is locked, or Face ID "wakes up" mid-scan, it can interrupt the process. Make sure the screen is fully unlocked and that you're not trying to scan while the phone is locking itself again.
If the scan fails, Apple itself offers a manual entry path on the same Add eSIM screen ("Enter Details Manually"), as described above. This isn't a workaround; it's part of Apple's standard installation flow.
Android-Specific Notes
On Android, the experience varies more between manufacturers. On Pixel and Samsung phones, the general path is Settings > Network & Internet > SIMs, then adding a new eSIM from there. But some Android devices require the scan to happen through the settings app's own built-in scanner, rather than the phone's regular Camera app. If you tried scanning through the Camera app and it didn't work, try again through the SIM menu in Settings, tap to add, and choose to scan from there.
If that still doesn't help, the "Add using activation code" (or "QR unavailable") option in the same menu leads directly to manual entry of the server address and activation code.
If you've made it this far and installed successfully, but you still don't have an internet connection, that's a different problem, usually related to line activation rather than the scan itself. In that case, check out our full guide: Troubleshooting an installed eSIM with no internet. And if you haven't purchased a plan yet, you can check all plans and coverage by destination before you continue.
Frequently asked questions
Can I scan an eSIM QR code from an image saved in my photo gallery, instead of directly from a screen?
Yes, on most devices you can. Open the code image in your gallery, zoom in until the squares are clear, and scan it just as you would from another screen. If your app doesn't support scanning from a saved image, that's one more good reason to go straight to manual installation.
How many times can I try scanning before the code stops working?
It depends on the provider, and there's no single number that applies to everyone. What is true in most cases: the problem is almost always the scan quality itself (lighting, focus), not the number of attempts. If a scan succeeds technically once but installation fails afterward, the code may already be considered "used" and won't work again, even if you try scanning it again right away.
What do I do if manual installation doesn't work either?
First, make sure you copied the server address and activation code exactly, with no extra spaces at the start or end. If it still fails, contact the support team for the provider you purchased the eSIM from and describe exactly what happened: the error message you received, whether it was the scan or the manual entry that failed, and at what step.
Do I need internet to install an eSIM?
Yes. Installing an eSIM, whether by scanning a QR code or entering details manually, requires an active internet connection (usually Wi-Fi) to download the eSIM profile from the server. Once installation is complete, you can disconnect from Wi-Fi and use the eSIM's own cellular connection.
I installed successfully but I don't have internet, what now?
That's a different problem from a failed scan, usually related to line activation or roaming settings. The full guide for fixing this is here: Troubleshooting an eSIM with no internet.
Affordable travel data for your next trip
Pick your plan, pay one clear price, and land online in about a minute — low prices, no roaming-bill surprises.
