Before you start
- Your iPhone supports eSIM. Apple says you need an iPhone XS, XS Max, XR or later. See which iPhones have eSIM.
- It’s unlocked. A carrier-locked iPhone may only accept an eSIM from that carrier. See how to check if your phone is unlocked.
- You have Wi-Fi or a hotspot. Apple says a Wi-Fi network or hotspot is needed during setup (in some countries, eSIM-only models can activate without Wi-Fi).
- You have your activation details. That’s a QR code, an install link, or the SM-DP+ address and activation code, from your carrier or eSIM provider.
- Your iPhone is up to date. Install the latest iOS version your phone can run.
Method 1: Scan the QR code
This is the most common way and works for almost every travel eSIM. Display the QR code on a second screen (a laptop, tablet or printout), because you can’t scan a code on the same iPhone using the camera.
- Open Cellular settings
Go to Settings > Cellular (or Mobile Data) and tap Add eSIM (you may see Set Up Cellular or Add Cellular Plan instead).
- Choose Use QR Code
Point the iPhone at the QR code. You can also open the Camera app, scan the code, and tap the Cellular Plan Detected notification.
- Continue and add the plan
Tap Continue, then Add Cellular Plan. If you’re asked for a confirmation code, enter the one your provider supplied.
- Wait for activation
Give the iPhone a moment to download the plan. When it finishes, tap Done and follow the on-screen prompts to label and set up the new line.
Method 2: Enter the details manually
Use this if the QR code won’t scan or your provider only gave you text codes.
- Open Add Cellular Plan
Go to Settings > Cellular (or Mobile Data) and tap Add Cellular Plan.
- Tap Enter Details Manually
It’s at the bottom of the screen.
- Enter your details
Type the SM-DP+ address and the activation code exactly as given, plus a confirmation code if your provider supplied one. Not sure what these are? See eSIM terms explained.
Method 3: Your carrier’s app or link
Some carriers install the eSIM for you. This can happen during iPhone setup, through the carrier’s app or website, or through a link they send. Apple calls the automatic version eSIM Carrier Activation: when a Carrier Cellular Plan Ready to Be Installed notification appears, tap it, tap Continue, and follow the prompts. If the carrier assigned an eSIM when you bought the iPhone, follow the on-screen instructions during setup.
After installing: set up the line for travel
These settings make the difference between “it installed” and “it works abroad without surprise charges”.
- Label the new line
Name it something clear, like Travel, and name your main line Primary. Labels help you pick the right line later.
- Pick your default line for calls and messages
For a travel data eSIM, keep your home SIM as the default for calls, messages and iMessage/FaceTime so friends can still reach you.
- Choose the line for mobile data
Under Settings > Cellular > Cellular Data, select the travel eSIM.
- Turn on Data Roaming for the travel eSIM
Go to Settings > Cellular, tap the travel eSIM line, tap Cellular Data Options, and turn on Data Roaming. Apple’s instructions for two lines say to tap the line you want to change first, so the setting applies to that line only.
- Keep roaming off on your home SIM
Tap your home SIM line, open Cellular Data Options, and make sure Data Roaming is off. Also switch off Allow Cellular Data Switching so the iPhone doesn’t quietly use your home line’s data abroad.
When should you install a travel eSIM?
Install it before you travel, on reliable Wi-Fi at home, so you’re not hunting for a connection at the airport. You don’t need to be in the destination country to install. Most travel eSIM providers start the validity period when the eSIM first connects to a network at your destination, but some start it at installation or on a chosen date, so read your provider’s note. When you land, switch the line on, confirm Data Roaming is enabled for it, and wait for the carrier name to appear in the status bar.
How long does eSIM activation take?
Downloading the plan normally takes a minute or two on a good Wi-Fi connection, and the line usually connects shortly afterwards. A few carriers need a few more minutes to switch the plan on at their end. If the line still shows no service after you’ve waited several minutes, work through the fixes below rather than deleting the eSIM.
If it won’t activate: fixes that work
Apple’s own troubleshooting guide for eSIM suggests this order. After each step, check whether your carrier’s name appears in the status bar.
- Check the basics
You’re on Wi-Fi or a hotspot, you have an active eSIM plan from a provider that supports eSIM, and your iPhone runs the latest iOS version it can.
- Toggle Airplane Mode
Turn Airplane Mode on, wait a few seconds, then turn it off.
- Turn the line off and on
In Settings > Cellular, find the eSIM line and switch it off, then on.
- Restart the iPhone
A full restart often clears a stuck activation.
- Update carrier settings
Open Settings > General > About. If an update for Network Provider is available, tap Update.
- Contact your provider
Give them the exact error message, your order number, and your iPhone’s EID or IMEI (both in Settings > General > About, and explained in eSIM terms).
| What you see | Likely cause | What to do |
|---|---|---|
| QR code won’t scan | Glare, small image, or already used | Enlarge the code on a second screen, or enter the details manually |
| “Cellular Plan Detected” never appears | No internet, or an older iOS version | Connect to Wi-Fi, update iOS, or use Settings > Cellular > Add eSIM |
| Plan says it can’t be added | The code was used before, or the phone is locked or unsupported | Contact your provider. Check the phone is unlocked and compatible |
| Installed but no data abroad | Data Roaming is off for the eSIM line, or it isn’t the selected data line | Turn on Data Roaming for the eSIM and select it under Cellular Data |
| No service | Weak coverage or the plan isn’t active yet | Toggle Airplane Mode, restart, then check the provider’s coverage list |
Do’s and don’ts
- Do keep your confirmation email and the QR code until you’re sure the eSIM works.
- Don’t delete the eSIM after installing it. A deleted eSIM often can’t be reinstalled from the same code.
- Do choose to keep the eSIM and plan if iOS asks when you erase or reset the iPhone.
- Don’t share your QR code. Anyone with it could install the plan before you do.
- Do consider how to transfer an eSIM before you replace your phone mid-trip.
