Skip to content
Landing eSIM
How-to guides

How to Install and Activate an eSIM on iPhone, Step by Step

Add an eSIM to your iPhone with a QR code, manual details or your carrier’s app. Clear steps, travel settings, and fixes if it won’t activate.

By the Landing eSIM editorial teamUpdated 8 min readChecked against official sources

Key takeaways

  • You need an eSIM-compatible, unlocked iPhone, an eSIM plan from a carrier or provider, and Wi-Fi for the download.
  • There are three ways to add it: scan a QR code, use your carrier’s app or link, or enter the details manually.
  • After installing, label the line, choose which line handles mobile data, and turn on Data Roaming for the travel eSIM only.
  • You can install a travel eSIM before you leave. Switch the line on when you arrive.
  • Don’t delete the eSIM afterwards. Many QR codes work only once.

To activate an eSIM on an iPhone, connect to Wi-Fi, open Settings > Cellular > Add eSIM, scan the QR code your provider gave you (or enter the details manually), then name the new line and turn it on. The install usually takes a few minutes, and you can do it before you travel.

This guide follows Apple’s own instructions and adds the settings that matter when the eSIM is a travel data plan, plus fixes for the most common problems.

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.

  1. 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).

  2. 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.

  3. 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.

  4. 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.

  1. Open Add Cellular Plan

    Go to Settings > Cellular (or Mobile Data) and tap Add Cellular Plan.

  2. Tap Enter Details Manually

    It’s at the bottom of the screen.

  3. 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.

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”.

  1. Label the new line

    Name it something clear, like Travel, and name your main line Primary. Labels help you pick the right line later.

  2. 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.

  3. Choose the line for mobile data

    Under Settings > Cellular > Cellular Data, select the travel eSIM.

  4. 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.

  5. 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.

  1. 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.

  2. Toggle Airplane Mode

    Turn Airplane Mode on, wait a few seconds, then turn it off.

  3. Turn the line off and on

    In Settings > Cellular, find the eSIM line and switch it off, then on.

  4. Restart the iPhone

    A full restart often clears a stuck activation.

  5. Update carrier settings

    Open Settings > General > About. If an update for Network Provider is available, tap Update.

  6. 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).

Common problems
What you seeLikely causeWhat to do
QR code won’t scanGlare, small image, or already usedEnlarge the code on a second screen, or enter the details manually
“Cellular Plan Detected” never appearsNo internet, or an older iOS versionConnect to Wi-Fi, update iOS, or use Settings > Cellular > Add eSIM
Plan says it can’t be addedThe code was used before, or the phone is locked or unsupportedContact your provider. Check the phone is unlocked and compatible
Installed but no data abroadData Roaming is off for the eSIM line, or it isn’t the selected data lineTurn on Data Roaming for the eSIM and select it under Cellular Data
No serviceWeak coverage or the plan isn’t active yetToggle 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.
Need a plan to install?Pick a destination, pay, and get your QR code instantly.Browse eSIMs

Frequently asked questions

  • Connect to Wi-Fi, go to Settings > Cellular > Add eSIM, scan the QR code from your provider (or choose Enter Details Manually), and follow the prompts. Then label the line and set it for mobile data.

  • Apple says you need a Wi-Fi network or a hotspot during setup, although in some countries eSIM-only iPhone models can activate without Wi-Fi.

  • Yes. Install it at home on Wi-Fi. Most travel eSIMs start counting validity when they first connect abroad, but check your provider’s terms.

  • The download usually takes a minute or two, and the line typically connects shortly after. If there’s still no service after several minutes, toggle Airplane Mode, restart the iPhone and check for a carrier settings update.

  • Not with the camera. Use a second screen or a printout. On iOS 17.4 or later, you can press and hold a QR code shown in an email or web page on the iPhone and tap Add eSIM.

  • Usually Data Roaming is off for the eSIM line, or the eSIM isn’t selected as the line for mobile data. Turn on Data Roaming in Settings > Cellular > the eSIM line > Cellular Data Options.

  • Yes, if your iPhone supports Dual SIM. Keep your regular SIM for calls and texts and use the eSIM for data.

  • Contact your provider. Many QR codes work once, and a code used on another device or deleted from this one may need to be reissued.

Get an eSIM for your tripLocal, regional and global plans, delivered instantly.

Sources and further reading

Device and carrier support changes often. If something here is out of date, please tell us and we will correct it. Read how we work in our editorial policy.

Share this guide

Keep reading

The app

We've got you covered, wherever

Buy, manage and top up eSIMs on the go. Until the apps ship, everything works in your browser at landingesim.com.

Coming soonApp StoreComing soonGoogle Play