Installing an eSIM on iPhone: the full guide
Installing an eSIM on iPhone takes only a few minutes, but the steps differ from a physical SIM card and it is easy to get one detail wrong right before a flight. Below are three working installation methods, an explanation of what choosing the data line actually means, and a rundown of the mistakes that stop an eSIM from activating or working in roaming as soon as you land.
What to check on your iPhone first
eSIM is supported on iPhone XR, XS, XS Max and newer, but not every unit sold in every country ships with eSIM enabled — some iPhones bought in certain regions work only with a physical SIM. If you are unsure, open Settings, then General, About, and look for EID and IMEI2 numbers — their presence confirms eSIM support.
The second condition is that the phone must not be carrier-locked. A locked iPhone can refuse to activate a third-party eSIM even if the hardware technically supports it. It is also worth updating iOS to the latest version before travelling, since older builds sometimes mishandle a carrier profile.
The install itself needs a stable Wi-Fi connection — the process downloads a carrier profile from the network, and a weak mobile connection can interrupt the download partway through.
The QR code from your email: the fastest way
After placing an order, you receive an email with a QR code. On the iPhone, open Settings, then Cellular (or Mobile Data), and choose Add eSIM. Several options appear — pick Use QR Code.
You can then point the iPhone's camera directly at the code on another screen, or at a printed copy, if the email is open on a computer or on paper — the profile is read straight away, with no app-switching. If the email is only open on the same iPhone you are installing on, you cannot photograph the code from its own screen, so use the method below instead.
Save a screenshot of the QR code email in your Photos ahead of time, so you can show it from another device even if your mail app is unreachable.
One-tap quick install
If the email is open on the very iPhone the eSIM is for, the quick install link or button — usually labelled Quick Install or Install eSIM — is more convenient. Tapping it opens Settings automatically and asks you to confirm adding the plan, with no QR scanning needed.
This method has one trap: opening the link in a different browser or forwarding it to a messaging app and opening it on another phone ties the install to the wrong device. Only open the quick install button on the exact iPhone travelling with you.
Manual SM-DP+ entry when the QR code won't scan
Sometimes the camera cannot read the code — screen glare, a low-resolution screenshot, or a camera restricted by an MDM corporate profile can all block it. In that case, under Add eSIM choose Enter Details Manually and type in the SM-DP+ address and the activation code from the email — both are usually printed as separate lines under the QR code itself.
Enter the address and code carefully, with no leading or trailing spaces: a stray character copied along with the text is a common cause of a 'Cannot connect to the cellular network' error.
Choosing the eSIM as your data line
After the profile is added, the iPhone asks which line to use for cellular data by default. Choose the new eSIM — you can do this during setup or later, in Settings, Cellular, Cellular Data.
It usually makes sense to keep the home physical SIM active for calls and texts but with data roaming switched off, so you don't get billed for accidental data use on your home plan abroad. Roaming for the eSIM itself, on the other hand, needs to be turned on — the toggle sits in that line's own settings.
Give both lines clear labels right away — for example 'Home' and the destination country — so you don't mix them up, especially once a few eSIM profiles from past trips have piled up on the phone.
- Cellular Data → set the new eSIM as the default line
- Data roaming for the home SIM → turn off
- Data roaming for the eSIM → turn on after landing
- Give both lines clear labels under Cellular
Common installation mistakes
Most problems come from the order of steps on the phone rather than the eSIM itself. Here is what usually goes wrong and how to fix it quickly.
- 'QR code already used' — a profile activates once on one device; switching phones requires a fresh profile
- Install stalls partway — switch to a different Wi-Fi network, a weak signal interrupts the profile download
- No internet after install — check that data roaming is switched on specifically for the eSIM line
- No signal right after landing — wait a couple of minutes for the phone to find the partner network, or toggle Airplane Mode for 10 seconds to speed up the search
If the eSIM still won't connect after all checks, try selecting the network operator manually in cellular settings — automatic search sometimes locks onto the wrong network first.