eSIM QR code not working: 9 quick checks before you panic

Short answer: If an eSIM QR code isn't working, it’s often due to connection, device, camera, software status, or the fact that the eSIM has already been installed. First, check your Wi-Fi, eSIM compatibility, iOS/Android version, the correct scanning method, and manual entry. Only then is it worth contacting support.

An eSIM error often feels bigger than it actually is. You have the QR code, you want to scan it, the phone doesn't react, or the activation hangs. In many cases, it’s not the QR code that is broken. The smartphone is simply not ready at one particular point.

1. Do you have a stable Wi-Fi connection?

Apple specifies a connection to Wi-Fi or a hotspot as a requirement for eSIM setup. This makes sense: your phone needs to download the mobile plan digitally. If the hotel Wi-Fi is shaky or the airport hotspot has captive portal issues, the activation might hang.

2. Is your device truly eSIM-compatible?

Not every smartphone with a modern camera supports eSIM. Check the specific model, not just the model series. For iPhones, eSIM is available from the iPhone XS, XS Max, and XR or later. For Android, it depends more on the manufacturer, market, and model.

3. Are you scanning the QR code in the right place?

On an iPhone, you can have the camera recognize the QR code or add an eSIM via mobile settings. Apple also states: if you are using iOS 17.4 or later and receive the QR code in Mail or a browser, you can press and hold it and select "Add eSIM".

4. Has the QR code already been used?

Many eSIM QR codes cannot be used as many times as you like, unlike a Wi-Fi password. If the eSIM has already been installed, a re-scan on the same or a different device may fail. Check your mobile settings to see if a new eSIM profile is already present.

5. Toggle Airplane mode on and off

Among other things, Apple recommends toggling Airplane mode on and off for activation issues. This is a quick reset for the network connection. Afterwards, check again if the eSIM line is displayed.

6. Restart the device

A restart sounds trivial, but it often helps after a partially completed activation. Afterwards, go back into the mobile or SIM settings and check if the plan is visible.

7. Use manual entry

If the camera doesn't recognize the QR code, look for "Enter details manually". Apple lists this option as an alternative. Some providers provide an SM-DP+ address and activation code for this. Type the details carefully, without any extra spaces.

8. Set data roaming correctly for the travel eSIM

For many travel eSIMs, data roaming must be enabled specifically for that eSIM. The distinction is important: don't just blindly enable it for all SIMs. Rename the eSIM clearly and select it as the line for mobile data.

9. Note the error message

If it doesn't work after that, take a screenshot of the error message or copy it down exactly. Apple recommends having the error message and device information such as the IMEI or EID ready when contacting the provider. For support, a precise error is better than "it doesn't work".

Mini decision tree

Conclusion

A non-functional eSIM QR code is usually no reason to panic. Calmly check your connection, device, software, scanning method, and settings. If you need support afterwards, you will have already collected the most important information and will reach a solution faster.

Status: September 2026. Menu names differ depending on the iOS/Android version and manufacturer. Always follow the instructions provided by your eSIM supplier in addition to these steps.