"Cellular plan cannot be added" and other add errors

An install error means the phone refused the eSIM, and the wording tells you why. The causes below are in the order they turn out to be true, with the message each one shows. Nothing is charged for a failed attempt, and your plan waits in My eSIMs.

Check first

If it gets interrupted, you'll see "Couldn't add your eSIM to this device." Your plan is safe, nothing was charged, and you can try again from My eSIMs.

Causes, in order

The connection dropped mid-download

Installing needs a steady Wi-Fi or data connection for about a minute. Move closer to the router, or switch from hotel Wi-Fi to your home SIM's mobile data, and start again from My eSIMs. Shows as "Cellular plan cannot be added" on iPhone, or a generic "Couldn't download" on Android.

The code has already been used

Each QR code installs one eSIM on one phone, once. If the plan is already on this phone, you'll find a KnowRoaming line you didn't expect in your SIM list. See "This code has already been used" error.

Your phone is carrier-locked

A locked phone refuses any second carrier's eSIM, usually as "Invalid SIM," "SIM Not Supported," or "This eSIM is not supported." See Carrier-locked, region-locked, or unlocked: how to tell.

Your phone has no room for another eSIM

Phones hold a limited number of eSIMs. Remove an old or expired one from another provider, then try again. Shows as "storage full" or similar on Samsung. See Phone at its eSIM limit: what to remove and what to keep.

The phone's date and time are wrong

The install checks a certificate, and a wrong clock fails it. Set date and time to automatic and try again. See Adding fails when your phone's date and time are wrong.

Your Galaxy model has no eSIM hardware

Some regional Galaxy variants don't support eSIM even within the same model line. The phone compatibility page lists the ones that do.

"SIM not provisioned" right after adding (Samsung)

The install worked; the line hasn't registered yet. Restart the phone. If it persists, turn Airplane Mode on for 30 seconds and off again, then check data roaming is on for the line.

Still not working?

Still not working? Message us on WhatsApp at +1-332-237-1910 and include four things: your ICCID, your order number, your phone model and OS version, and what you've already tried.

常见问题解答

Send a message. 我们会帮你搞定的。

搜索功能不错,文档也相当不错,但有时你就是想找个人聊聊。这就是我们存在的意义。无论哪个时区,无论什么问题,无论何时。

在 WhatsApp 上聊天