eSIM QR code not scanning? Every fix that works
Contents
A QR code that won't scan is almost always a quick fix, not a broken eSIM. Your Zwitchy code is fine — the camera just can't read it yet. Work through the steps below in order and you'll be installed in a couple of minutes.
Why a QR code won't scan
Scanning fails for a handful of ordinary reasons. Once you know which one you're hitting, the fix is obvious.
- Screen brightness is too low, or glare is washing the code out.
- The code is displayed too small for the camera to focus on.
- The camera lens is dirty, smudged, or partly covered by a case.
- You're trying to scan the code with the same phone that's showing it — a camera can't photograph its own screen.
- The code was already installed on a device, or it has expired — a QR code is single-use.
The fixes, in order
Try these one at a time. Most people are sorted by step two or three.
- Turn your screen brightness all the way up and switch off auto-brightness, then move out of direct sunlight to kill glare.
- Make the code bigger. Zoom in on the image, or open your Zwitchy order on a laptop or tablet so the code fills a larger screen.
- Open the code on a second screen. If you only have one phone, this is the key step — the eSIM has to be scanned from a different display, or typed in by hand (below).
- Print the code. A clean copy on white paper scans reliably and needs no second device.
- Clean the camera lens with a soft cloth and remove any case or cover sitting over it.
- Hold the phone steady, about 10–20 cm from the code, and give the camera a second to focus before it locks on.
One phone only? You can't scan a code from the screen that's showing it — use manual entry instead, and you'll be set up just as fast.
Manual entry: the fallback that always works
Every eSIM QR code is just a short block of text hidden behind the image, so you never truly need the camera. When you add an eSIM, choose Enter details manually (iPhone) or Enter it manually (Android), then type the SM-DP+ address and activation code from your Zwitchy order. Our step-by-step manual activation guide walks through it, and you can reopen your code any time from your install page.
iPhone and Android notes
The wording differs slightly by platform, but the flow is the same: open Settings, add a cellular or mobile plan, then scan or type the code. If you're new to it, our full eSIM setup guide covers both platforms.
| Platform | Where to add your eSIM |
|---|---|
| iPhone | Settings → Cellular (or Mobile Data) → Add eSIM |
| Android | Settings → Network & internet → SIMs → Add eSIM |
On iPhone, if the camera won't lock on, tap Enter Details Manually on the Add Cellular Plan screen. Apple's official guide to set up eSIM on iPhone shows every step.
On Android the menu names vary by brand, but under SIM settings you'll always find an Add eSIM or Download a SIM instead option, with a manual-entry link on the scan screen. Google's guide to using an eSIM on Pixel is a solid reference.
Was the code already used?
A QR code can only be installed once. If scanning succeeds but you get an error like “unable to add” or “code already used,” the eSIM is probably already on a device.
- You already scanned it on this or another phone — check Settings for an eSIM or plan you don't recognise.
- Someone you forwarded the order to installed it.
- You deleted the eSIM after installing — deleting it does not free the code to reinstall.
Don't delete a Zwitchy eSIM to “start over.” Deleting it spends the one-time code and the plan can't be reinstalled — open our connection troubleshooting guide instead if it isn't working.
After it installs: don't skip this
Installing the eSIM does not start your plan — your data and validity only begin when you switch the eSIM on at your destination. A few settings make sure it connects to the right network and never touches your home carrier.
- On the Zwitchy travel eSIM, turn Data Roaming ON — that's how it reaches our local partner networks, and it never bills your home carrier.
- Keep your home SIM's roaming OFF, and turn off automatic data switching so your phone can't drift back to it.
- Leave your home SIM active for calls, texts and bank OTP codes — Zwitchy is data-only, so you keep your own number.
- Set the Zwitchy eSIM as your data line once you land; if you run low, a top-up attaches to the same eSIM instantly.
Can I scan the QR code with the same phone I'll use the eSIM on?
Not from its own screen — a phone can't photograph its own display. Show the code on another screen, or use manual entry to type it in. The eSIM still installs on the phone you want to use it on.
The code scanned once and now won't scan again. What happened?
QR codes are single-use. Once an eSIM is installed, the code is spent — even if you later delete the eSIM. If you think it installed by mistake, check your device's cellular settings before doing anything else.
Do I have to scan at all?
No. Every code has a text version (an SM-DP+ address and an activation code). Choose manual entry when adding the eSIM and type those in — it's just as reliable as scanning.
Does installing the eSIM start my plan or use data?
No. Installing only loads the profile. Your data allowance and validity begin only when you switch the eSIM on and connect at your destination, so it's safe to install at home on Wi-Fi before you travel.
Will using the travel eSIM give me a roaming bill?
No. Data Roaming on the Zwitchy eSIM connects you to local partner networks, not your home carrier. Keep your home SIM's roaming off and you'll never see a roaming charge.
