A QR code that will not scan is frustrating when you are trying to get connected before a flight or just after landing. The good news: most issues are quick to fix. To troubleshoot eSIM QR code scanning, start by checking where the code is displayed, whether your phone supports eSIM, and whether you have a reliable internet connection for installation.
An eSIM QR code contains the details your phone needs to download a mobile data plan. It is not a regular website code, so your device must scan it from the eSIM setup screen - not just through the standard camera app. A few simple checks can get your travel data plan installed and ready to use.
Start With the Right Setup Screen
On an iPhone, open Settings, select Cellular or Mobile Data, then choose Add eSIM. Select Use QR Code when that option appears. On many Android phones, go to Settings, then Network & Internet, Connections, or SIM Manager, depending on the manufacturer. Look for Add eSIM, Add Mobile Plan, or a similar option.
Your phone should open a dedicated QR scanner within this menu. Scan the code there. If you scan it in your regular camera app, it may show a message, open nothing, or treat the code as unreadable because the camera is not being used to add a cellular plan.
The wording and menu path can differ by phone model and software version. If you cannot find the eSIM option, use the Settings search bar and enter “eSIM,” “SIM,” or “mobile plan.”
You Cannot Scan a Code Displayed on the Same Phone
This is one of the most common travel setup problems. If your QR code is in an email, browser tab, or screenshot on the same phone where you want to install the eSIM, the device cannot point its camera at its own screen.
Open the QR code on another screen instead. A laptop, tablet, a travel companion’s phone, or a printed copy will work. Increase the code size until it is clear and fully visible, then scan it from your phone’s eSIM setup screen.
If you only have one device available, look for the manual installation details included with your eSIM delivery. These usually include an activation address and activation code. Your phone may offer an Enter Details Manually option below the QR scanner. Enter every character exactly as shown, including punctuation if provided.
Check Your Internet Connection Before Installing
An eSIM needs an internet connection to download its profile. Wi-Fi is usually the easiest choice before you travel. If you are already abroad, connect to trusted hotel, airport, café, or accommodation Wi-Fi while you install the plan.
A weak or unstable connection can make the QR code appear to fail even when the scan worked. The phone may recognize the code, begin adding the plan, and then stop during download. Move closer to the Wi-Fi router, switch to a more reliable network, or temporarily turn off a VPN if one is interfering with the connection.
Do not worry if the eSIM installs but does not show data service immediately. Some travel plans activate when they first connect to a supported network at your destination. Installation and activation are related, but they are not always the same moment.
Make Sure Your Phone Is eSIM-Compatible and Unlocked
Before spending more time trying to scan, confirm that your device supports eSIM. Most recent iPhones, Google Pixel phones, Samsung Galaxy models, and many newer devices do, but compatibility can vary by model, country of purchase, and carrier version.
Your phone also needs to be carrier-unlocked. A carrier-locked device may scan the code correctly but reject the plan when it tries to add it. In some cases, the phone will display a message such as “Cellular Plan Cannot Be Added” or “This code is no longer valid.” The exact wording does not always identify the real cause, so checking the lock status is worthwhile.
On iPhone, open Settings, choose General, then About, and look for Carrier Lock. It should say No SIM Restrictions. On Android, the process varies, but your current carrier can confirm whether the device is unlocked.
Improve the QR Code Scan
A blurry, cropped, low-contrast, or damaged image may not scan. If the QR code was sent by email, download the original image or reopen the email rather than using a compressed screenshot. Avoid scanning a code that has been enlarged so much that its edges become fuzzy.
Clean your phone’s camera lens and use good lighting. Keep the entire QR code inside the scanner frame, hold the phone steady, and move it slightly closer or farther away until it comes into focus. A screen brightness level around 70 to 100 percent on the device displaying the code can also help.
If you printed the code, make sure it is sharp and not cut off at the edges. A black-and-white print is normally fine, provided the squares are clear.
Restart the Setup Process
When the scanner freezes or repeatedly fails to recognize a readable code, close the Settings app and restart your phone. Then return to the eSIM setup menu and try again. This small reset can clear a temporary camera or network issue.
Also check for a pending phone software update. You do not need the newest device to use eSIM, but an outdated operating system can occasionally cause activation or settings problems.
If the Phone Says the QR Code Is Invalid
A QR code can be valid but still rejected for a few reasons. First, make sure you are scanning the code assigned to the exact plan you purchased. If you have multiple trip plans or older emails, it is easy to select the wrong one.
Second, many eSIM activation codes are designed for one installation only. If the plan was already added to your phone, scanning the code again may produce an error. Check your device’s cellular settings for a newly added plan before assuming installation failed. It may appear under a generic label at first, rather than your destination name.
Do not delete an eSIM just to retry the QR code unless you are certain you no longer need it. Some plans cannot be reinstalled with the same code after removal. If the plan is present but not working, adjust its settings first.
For example, make sure the new eSIM line is turned on, selected for cellular data, and allowed to use data roaming if your provider’s instructions require it. Keep your primary line available for calls and texts if you want, but turn off cellular data switching if you do not want your home carrier to take over and create roaming charges.
Troubleshoot eSIM QR Code Scanning on Android
Android setup screens differ more than iPhone screens, so the labels may not match exactly. Samsung devices often use SIM Manager, while Pixel devices commonly use Network & Internet and SIMs. In both cases, you are looking for the option to download or add an eSIM.
If the QR scanner does not open, confirm that the phone has permission to use its camera. Also check whether your device has reached its active SIM or eSIM limit. Some phones can store several eSIM profiles but allow only a limited number to be active at once. Temporarily turning off an unused line may let you add the new travel plan.
Dual-SIM behavior also depends on the model. If your phone supports only one active eSIM at a time, you may need to switch your active line after installation. That is normal and does not mean the travel eSIM has failed.
Know When to Ask for Help
If the QR code is clear, you have used the dedicated eSIM scanner, your phone is unlocked and compatible, and manual entry also fails, stop retrying the same steps. Take a screenshot of the exact error message and keep your order details available. Support can identify whether the issue is related to the device, the installation code, or the plan status.
For eSIMGo customers, the most useful details are the phone model, operating system version, destination, and a screenshot of the error. Never share the full QR code publicly or post it in a comment. It contains activation information intended only for your device.
Give yourself a few minutes to install your eSIM while you still have dependable Wi-Fi, ideally before departure. Once the profile is added correctly, you can arrive focused on the trip ahead instead of searching for a SIM card or paying for surprise roaming.