eSIM QR Code: How to Get One, Scan It, and Fix It When It Won’t Work

What an eSIM QR code actually is

Let’s clear this up first. The eSIM QR code isn’t your plan. It’s the key that unlocks your plan. Scan it and the code tells your phone two things: which server to talk to (the SM-DP+ address, in the jargon) and a one-time activation code that proves you’re allowed to download that specific profile.

Once your phone reads it, the actual eSIM profile gets pulled down over the internet and installed onto a tiny chip soldered into the device. That chip can hold a stack of profiles at once, most phones manage eight to twenty, though only one or two run at a time. The QR code is just the handshake that gets a new one onboard. After that first install, the code has done its job, which is exactly why most of them stop working the second time you try. More on that headache below.

If you want the bigger picture on how the chip itself works versus a removable card, our explainer on what an eSIM card is walks through the hardware side. This guide stays tight on the code.

How to get your eSIM QR code from a carrier

This trips people up more than the scanning does. Where the code lives depends entirely on how you bought the plan. A few common spots:

• By email. Buy an eSIM online and most carriers email you a QR code, often as a PDF or an image attachment. Open it on a second screen (a laptop, a tablet) so you can scan it with the phone you’re setting up.
• In the carrier’s app or account dashboard. Log in, find your line or order, and there’s usually a “view QR code” or “activate eSIM” option. This is handy because you can re-summon it if you fumble the first scan.
• On a printed card or receipt. Some prepaid and travel eSIMs ship a little card with the code printed on it. Don’t toss it until the line’s working.
• No code at all. Plenty of carriers skip the QR entirely now and activate straight from their app, or push the profile to your phone with a tap. US Mobile works this way, and Apple’s Quick Transfer can move an eSIM between iPhones with zero scanning.

Quick tip. Whatever form your code comes in, you scan it with the phone that’s getting the new line, not the phone showing the code. That’s why having it on a separate screen makes life easier.

How to scan an eSIM QR code on iPhone

Get on Wi-Fi first. The profile downloads over the internet, so signal doesn’t matter yet but a solid connection does. Then:

1. Open the eSIM setup screen

   Settings > Cellular (it might say Mobile Service) > Add eSIM. Older iOS versions phrase it “Add Cellular Plan.”

2. Choose Use QR Code

   Your camera opens inside the setup flow. Point it at the code.

3. Line the code up in the frame

   Hold steady until the phone catches it. If the code’s on paper, decent lighting helps a lot here.

4. Confirm and label the line

   The iPhone downloads the profile. Give it a name (“Personal”, “Travel”) so you can tell lines apart if you run two.

5. Set your default line

   Pick which line handles calls, texts, and data. You can change it anytime, even per contact.

The line goes live in a few minutes. One shortcut worth knowing: if the QR code is sitting in a Photos screenshot or an email on the same iPhone, you can sometimes long-press it and tap “Add eSIM” without the camera at all.

How to scan an eSIM QR code on Android

The wording shifts a little brand to brand, but the route is the same idea as iPhone.

1. Connect to Wi-Fi

   Same reason as before. The profile comes down over the network.

2. Open the SIM settings

   On Pixel: Settings > Network & internet > SIMs > Add SIM. On Samsung Galaxy: Settings > Connections > SIM manager > Add eSIM.

3. Skip the physical SIM prompt

   When it asks you to insert a SIM card, pick “Download a SIM instead” (Pixel) or “Scan QR code from carrier” (Samsung).

4. Scan the code

   Point the camera at your carrier’s QR code and let it focus. If there’s an activation confirmation code, type it when prompted.

5. Turn the eSIM on

   Toggle the new line on, set it for calls and data, and you’re connected.

No QR code? Enter the details by hand

Sometimes there’s no scannable square. Maybe the email only came with text, or the camera just refuses to lock on. Every modern phone has a manual fallback for exactly this.

It feels fiddlier than scanning, sure, but it gets you to the exact same place. And honestly, if your carrier hands you these details directly, manual entry can be faster than hunting down a printed code.

When the QR code won’t scan or says it’s already used

Here’s where most of the support tickets come from. The good news is the fixes are short. Work through these in order.

1. The camera won’t read it

   Clean the lens, boost the brightness on whatever screen shows the code, and back off a couple of inches so the whole square fits in frame. Blurry or cropped codes are the usual culprits.

2. Check you’re on Wi-Fi

   The scan can succeed but the profile still fails to download if there’s no internet. Confirm Wi-Fi is on before you blame the code.

3. “Code already used” or “unable to add”

   Most eSIM QR codes are single-use. If you scanned it once already, even on a phone you’ve since wiped, it can be spent. Ask your carrier to issue a fresh code rather than reusing the old one.

4. Make sure the phone is unlocked

   A device locked to a different carrier may refuse a new eSIM. You’ll need it carrier-unlocked first.

5. Restart, then escalate

   A reboot clears a surprising number of these. Still stuck? Contact your carrier and request a new activation QR. Reissuing one is routine for them.

How to get a US Mobile eSIM QR code free

If you’d rather skip the email-and-scan dance entirely, this is the easy path. US Mobile generates your eSIM QR code right in the setup flow, so there’s nothing to dig out of an inbox. The free trial gives you 30 days and 30GB of data on Warp 5G or Dark Star. You’ll add a payment method to start, but you aren’t charged during the trial, and there’s no contract if you walk away.

1. Start at get-started

   Go to usmobile.com/get-started and create an account or log in.

2. Add a new line, then Special Offers

   Choose “Free Trial” and continue. Skip the physical Starter Kit and pick eSIM activation.

3. Choose your network and transfer your number

   Select Warp or Dark Star. The trial asks you to bring your existing number over to qualify.

4. Scan the QR code it shows you

   Confirm and activate, then scan the on-screen QR code with your camera. Your line is live in a few minutes.

Paid plans start at $8/mo for light users and $25/mo for Unlimited Starter, all with eSIM, no activation fee, and no contract. If you want the full play-by-play, the step-by-step on how to activate an eSIM covers every screen in detail.