eSIM error messages, explained (and how to fix each one)
Contents
An eSIM error message is rarely a real problem with your eSIM. It's your phone reporting exactly where in a multi-step handshake, download the profile, install it, then connect to a network, something got interrupted. The wording varies by manufacturer and even by carrier, which makes it feel cryptic, but almost every message on this page maps to one of a handful of causes. This is a reference: find what's on your screen, see what it actually means, and jump straight to the fix instead of guessing.
Why the wording is so inconsistent
When you scan a QR code or tap an install link, your phone contacts a provisioning server, downloads an encrypted eSIM profile that's tied to your device, and installs it. Every step needs a live internet connection, and the activation code behind that QR is generally valid for one successful download. That's the whole system. Apple, Google and Samsung each phrase the failure states of that process differently, and some carriers add their own numbered error codes on top for their own account systems. None of that changes the underlying fixes, which is why the same three or four causes keep showing up under different names.
Errors during setup, before the eSIM finishes installing
| What you see | What's actually happening | Fix |
|---|---|---|
| "Could not add eSIM" / "Couldn't add cellular plan" | The download was interrupted, usually a dropped or restricted Wi-Fi connection | Reconnect to a strong, stable Wi-Fi network (avoid a VPN or a captive portal) and try again |
| "Cellular Plan Error" or the install just stalls | Generic Apple failure state during the download step | Toggle Airplane Mode, restart the phone, then retry the install |
| "Cellular Plans From This Carrier Cannot Be Added" | The phone is network-locked to a previous carrier | Contact whoever sold you the phone and ask for a carrier/SIM unlock, this has nothing to do with the eSIM itself |
| "This eSIM is already in use" / install silently fails on a repeat scan | The activation code was already redeemed, most codes work once | Don't rescan an old QR; if you never completed setup the first time, ask Zwitchy support for a fresh activation link |
| "eSIM limit reached" or setup won't proceed at all | Your device has hit its stored-profile limit (most phones hold five to ten, even if inactive) | Delete an old, unused eSIM profile from Settings, then retry |
If you're not sure which of these you're looking at, Apple's own eSIM setup guide walks through the same first checks in order: Airplane Mode, the Cellular settings screen, then a restart. It's a good first pass regardless of phone. A locked phone specifically is worth ruling out before anything else, here's how to check if yours is carrier-unlocked. And if the QR itself won't scan rather than failing after, that's a separate fix covered in every reason a QR code won't scan.
Errors after the eSIM is installed but won't connect
Once a profile is installed, the messages shift from setup language to connection language. "No Service," "SOS," or "Emergency calls only" in the status bar all mean the same underlying thing: your phone doesn't have an active line talking to a network right now. Samsung's own support documentation confirms "Emergency calls only" appears specifically when there's no active eSIM or SIM selected, or the profile isn't active yet, which is usually a data-line setting, not a broken eSIM.
"No Service" on install day is almost never the eSIM failing. It's nearly always Data Roaming turned off, the wrong line set for mobile data, or a network that hasn't finished registering the profile yet.
These are covered step by step, with exact settings paths for iPhone and Android, in our full eSIM won't connect troubleshooting guide. Start there if the status bar shows no service after install; this page is about decoding the message, that one is about fixing the connection.
The one that isn't really an error
If you run Dual SIM and see "No Service" on your second line specifically while you're mid-call on the first, that's expected behavior, not a fault. Apple documents this directly: a phone can only use one cellular data connection at a time, so the line you're not actively using shows as unavailable until the call ends. Turning on Wi-Fi Calling for that number is the workaround if you need both reachable at once.
Numbered error codes instead of plain English
Some carriers layer their own numbered codes over the standard eSIM flow. T-Mobile, for example, publishes a whole catalog mapping codes like 511 or 506 to specific account issues such as a security hold or a missing internet connection. Those numbers are internal to that carrier's own systems and won't mean anything on a Zwitchy eSIM or any other provider's. If your screen shows a numeric code rather than a plain-English message, don't try to look it up against a different provider's list, screenshot it and send it to Zwitchy support instead; we can read it directly against our own provisioning logs.
Quick reference: symptom to cause
- Install screen won't move past "Downloading": weak or restricted Wi-Fi, or a VPN interfering with the download
- Install fails immediately on scan: the QR was already used, or it's for a different device
- "Locked" or "cannot be added" during setup: the phone itself is carrier-locked, unrelated to the eSIM provider
- Install succeeds but status bar shows no signal: Data Roaming or the data-line selection, not the eSIM
- A numbered code with no explanation: carrier- or provider-specific, contact support directly
One more thing worth knowing: none of these failure states use up your data allowance or your plan's validity window. A failed install is free to retry as many times as it takes, and reinstalling a working eSIM doesn't reset or shorten your plan.
Still stuck?
If you've matched your message above and the fix didn't clear it, or the wording on your screen isn't listed here at all, live chat is open 24/7 and the fastest way to get a human to look at it. Have the exact error text or code ready, plus your order number, it cuts the back-and-forth down to almost nothing. And if an eSIM genuinely can't be activated on your device, unused plans are refundable within 30 days.
Does a failed eSIM install cost me data or delay my plan?
No. Nothing is deducted and your plan's validity window doesn't start until the eSIM actually activates on a network. A failed or retried install is free.
Why does the same error show different text on my friend's phone?
Apple, Google and Samsung each write their own wording for the same underlying failure. The cause (a dropped connection, a locked phone, a reused code) is usually identical even when the message isn't.
I see a number instead of a message, what do I do?
Numbered codes are usually specific to a carrier's own account system rather than the eSIM itself. Send the exact number to support rather than searching for it generically, it likely won't match a different provider's list.
Can I just keep rescanning the same QR code until it works?
Most activation codes are single-use, so a second scan after a successful install will fail or show an "already in use" style message. If the first attempt didn't fully complete, ask support for a fresh code rather than repeating the scan.
Is "No Service" right after install a sign something's broken?
Almost never. It's the most common message people see in the first minute, and it's nearly always Data Roaming or the data-line setting rather than a faulty eSIM. See our full connection guide for the exact fix.
