You hold your phone up to the eSIM QR code and nothing happens. The camera will not read it, or it reads it and throws an error, and your activation stalls before it even begins. A QR code that will not scan is frustrating, but the cause is usually simple and fixable. Here is why it happens and how to get the code to work on both iPhone and Android.
Table of Contents
Why eSIM QR Codes Fail to Scan
An eSIM QR code is just a way of delivering the activation details to your phone. When it will not scan, the problem is almost always one of three things: the code is hard for the camera to read, the phone is having a temporary glitch, or the underlying activation details are no longer valid. The good news is that you can almost always work around a scanning problem by entering the details by hand.
Step 1: Improve the Scanning Conditions
Start with the basics, because most scan failures are about how the code is presented to the camera.
Make sure the code is well lit and not washed out by glare. If it is on a screen, turn up that screen’s brightness and avoid reflections. If it is printed, flatten any creases. Hold the phone steady about 15 to 20 centimetres away and let the camera focus. Clean the camera lens if it is smudged. A blurry or poorly lit code is the single most common reason a scan fails.
If the code is on the same phone you are trying to activate, you cannot scan your own screen. In that case you will need to use the manual entry method described below, or display the code on another device.
Step 2: Restart and Try Again
A temporary glitch in the camera or eSIM setup flow can block a scan that should work.
Restart the phone, then start the eSIM setup again. On iPhone, go to Settings, Cellular, Add eSIM, and choose to use a QR code. On Android, go to the SIM manager or network settings, add an eSIM, and select the scan option. A fresh start often clears whatever was interfering.
Step 3: Use Manual Entry Instead
If the code still will not scan, you can usually bypass it entirely. Most carriers provide the same activation details in text form alongside the QR code, typically an SM-DP+ address and an activation code, sometimes labelled as a confirmation code.
On iPhone, choose to add an eSIM, then select the option to enter the details manually. On Android, look for a manual entry or “enter activation code” option in the eSIM setup flow. Type the details exactly as provided, paying attention to capital letters and avoiding extra spaces. This is the most reliable workaround for a code that refuses to scan.
If you only received a QR code and no text details, contact your carrier and ask for the manual activation details. They can provide the SM-DP+ address and activation code that the QR code encodes.
Step 4: Check for an “Already Used” Code
If the code scans but returns an error rather than activating, the activation details may already have been consumed. Most eSIM codes are single-use, so if the profile was downloaded on another device or on a previous attempt, the code will fail.
Check whether the eSIM is already installed under your cellular settings. If it is, you do not need to scan again. If it is not, and the code reports as used, the carrier will need to issue a fresh activation. Deleting an eSIM does not restore the original code.
Step 5: Update and Confirm Compatibility
An outdated operating system can cause problems in the eSIM setup flow.
On iPhone, install any pending update under Settings, General, Software Update. On Android, install pending system updates from the update section. While you are at it, confirm your phone actually supports eSIM, since not every model does and some regional versions ship without it. If the hardware has no eSIM, no code will activate one.
Step 6: Contact Your Carrier
If the code will not scan and manual entry also fails, the issue is likely with the activation details themselves.
Have your account information and your device EID ready, found under Settings, General, About on iPhone or in the about section on Android. Ask the carrier to confirm the activation details are valid and assigned to your device, and to re-issue them if needed. They can also push the eSIM to your device remotely using the EID, which skips the QR code completely.
A Quick Order to Try
For the fastest result, do this. Improve the lighting and steady the phone, then rescan. If that fails, restart and try again. If it still will not scan, switch to manual entry using the text details. If manual entry fails too, call the carrier to confirm or re-issue the activation details.
When to Escalate
If the carrier confirms the details are valid and assigned to your device but neither scanning nor manual entry works, ask them to push the eSIM remotely using your EID or to issue a completely fresh activation. A valid code that will not install through either method usually needs a clean re-issue. If even a fresh profile fails to install, the device manufacturer can help rule out a software fault.
Most scanning problems come down to lighting, focus, or trying to scan a screen on the same phone, and manual entry solves nearly everything else. Between the workaround and a carrier re-issue, a code that will not scan is rarely a real obstacle.