eSIM QR Code Explained: What's in It and How to Fix Common Errors

An eSIM QR code isn't a photo or a logo — it's an encoded string that tells your phone exactly where to download your specific carrier profile from, and it's built to work exactly once. Here's what's actually in it, and what to do when it doesn't scan.

Key Takeaways

- The QR code encodes a fixed-format activation string — your provider's server address plus a unique ID tied to your specific eSIM profile (GSMA SGP.22, 2026).

- Most eSIM QR codes are valid for one installation only — the ID is invalidated by the provider's server the moment it's successfully used, by design, for security.

- "Already used" or "no longer valid" errors mean the code itself is spent — that's fixed by contacting your provider for a new one, not by retrying on your phone.

What's actually inside an eSIM QR code?

The QR code encodes an activation string in a standardized format defined by the GSMA (the mobile industry's standards body): your provider's SM-DP+ address — the server that holds your specific eSIM profile — plus a unique Matching ID that ties the code to that one profile (GSMA, 2026). Scanning it just feeds your phone that string faster than typing it — everything the code does, you could also do by entering the address and ID manually.

Why can you only scan it once?

Once your phone successfully uses the Matching ID to download the profile, the provider's server invalidates that ID — it's deliberately single-use, so the same profile can't be installed on a second device by anyone who happens to see or copy the code. That's a security feature, not a bug: it's the same principle that keeps a physical SIM from working in two phones simultaneously, applied to a digital code instead of a card.

Why does my eSIM QR code say "already used" or "no longer valid"?

This means the Matching ID has already been consumed — either you (or someone else) successfully installed it once before, or in some cases an interrupted install still consumed the code even though the eSIM never finished setting up. Either way, this isn't something you can fix from your phone's settings; retrying the same QR code won't work because the code itself is spent. The fix is contacting your provider — most reissue a fresh QR code or activation link once you confirm you haven't successfully activated the plan elsewhere.

My camera won't scan the QR code — what else can I do?

You don't need the camera at all. Every eSIM QR code can be installed by manually entering the same two pieces of information it encodes: the SM-DP+ address and the activation/Matching ID, both of which your provider also lists as plain text alongside the QR code. On iPhone, this is available directly in Settings > Cellular > Add eSIM > Enter Details Manually. If scanning specifically is failing, check that the QR code image isn't compressed or cropped by whatever app you're viewing it in — screenshots and forwarded images sometimes lose enough resolution for the camera to read it.

Do I need Wi-Fi to scan the QR code?

You need an internet connection to install the profile, since your phone downloads it from the provider's server after scanning — Wi-Fi is the standard recommendation so you're not relying on cellular data you may not have yet. Some newer eSIM-only phone models can also complete this over a cellular connection in supported regions, but installing before you fly on Wi-Fi remains the more reliable approach. If you haven't activated a travel eSIM before, our step-by-step activation guide covers the full install-then-activate sequence.

Frequently asked questions

Can I reuse an eSIM QR code on a new phone?

No — once successfully used, the code is invalidated on the provider's server regardless of which device scanned it. If you got a new phone, you'll need your provider to issue a new eSIM profile, not reuse the old QR code.

Can I screenshot or print my eSIM QR code?

Yes, that doesn't affect whether the code works — what matters is whether it's already been successfully installed once, not how you're viewing or storing the image.

Why does scanning fail even though the QR code looks fine on screen?

Usually either the code has already been used (check for an "already used" or "no longer valid" message specifically), or the image quality has degraded enough — through compression, cropping or a small screen — that the camera can't read it cleanly. Manual entry using the SM-DP+ address and activation code sidesteps both issues.

Sources

• GSMA, SGP.22 Technical Specification (RSP consumer eSIM standard), retrieved 2026-07-07, https://www.gsma.com/solutions-and-impact/technologies/esim/gsma_resources/sgp-22-v2-2-2/
• Apple, If you can't set up an eSIM on your iPhone, retrieved 2026-07-07, https://support.apple.com/en-us/102478