How to Set Up eSIM on iPhone: Step by Step

eSIMer Team · · Updated · 11 min read

iPhone Settings showing Add eSIM under Cellular

Knowing how to set up eSIM on iPhone takes the stress out of landing abroad: you install the travel line at home in a few minutes, then switch it on when the plane touches down. The usual problems are scanning the code at the last minute without Wi-Fi, or forgetting to move mobile data to the new line.

To set up an eSIMer eSIM on your iPhone:

  1. Buy a plan for your destination on esimer.io or in the eSIMer app.
  2. On Wi-Fi, open Settings > Cellular > Add eSIM > Use QR Code and scan your eSIMer QR code.
  3. Label the new line, for example "eSIMer Travel".
  4. At your destination, choose that line for Cellular Data and turn on Data Roaming for it.

How to get an eSIM for your iPhone

  1. Check the phone. Your iPhone must support eSIM and be carrier-unlocked. If you see Add eSIM under Settings > Cellular, the hardware supports it. Ask your carrier if you are unsure about the lock. Our compatible devices page helps too.
  2. Pick a plan. Open eSIMer data plans, choose a country or region, and select a data size and validity.
  3. Get the QR code. After purchase, the QR code is in your order on the website and in the app. Open it on a second screen, such as a laptop, so you can scan it with the iPhone.
  4. Install, label and wait. Follow the steps below. Leave the line off for data until you arrive, unless your plan instructions say otherwise.

How to set up eSIM on iPhone, step by step

Before you start

  • Connect to stable Wi-Fi. The profile downloads over the internet.
  • Have the QR code open on another device, or note the manual details in your plan instructions.
  • Do not delete an existing travel eSIM unless support asks you to. Many profiles cannot be installed again after deletion.

Install with the QR code

  1. Open Settings and tap Cellular (called Mobile Data in some regions).
  2. Tap Add eSIM.
  3. Choose Use QR Code.
  4. Point the camera at the eSIMer QR code and follow the prompts.
  5. When asked, give the line a clear label such as eSIMer Travel.
  6. If iOS asks which line to use as default, keep your Primary line for calls and messages if you still need your regular number.

Install with manual details

If you cannot scan the code, for example because it is on the same phone, choose Enter Details Manually on the Use QR Code screen and type in the details from your plan instructions exactly as shown.

Turning it on at your destination

Installing the eSIM adds the profile. For most eSIMer plans, the validity starts only when the eSIM first connects to a supported network, so you can install early without losing days. Some plans start on installation or purchase, so read the plan details. More on this in when does an eSIM plan start.

When you land:

  1. Go to Settings > Cellular > Cellular Data and select eSIMer Travel.
  2. Tap the eSIMer Travel line and switch Data Roaming on. Travel eSIMs connect through partner networks, so roaming must be on for this line.
  3. Tap your home line and switch its Data Roaming off, so it cannot use your carrier's data.
  4. Turn off Allow Cellular Data Switching if you see it, so iOS does not fall back to your home line.
  5. Wait a few minutes for the phone to register on a local network.

If the eSIM does not connect

If the line does not connect within a few minutes of landing, find the symptom you are seeing in the next section and follow its steps in order. The full travel checklist is also in eSIM not working abroad.

Common iPhone eSIM error messages and what to do

Most setup problems show up as one of a handful of messages or symptoms. Here is what each one usually means and the order to work through it. The steps combine our Help Center guide to installing an eSIM on iPhone with Apple's own articles, Set up eSIM on iPhone and If you can't set up an eSIM on your iPhone.

The QR code will not scan

What you see: the camera opens but nothing happens, or no "Cellular Plan Detected" notification appears.

What to do:

  1. Make sure you are scanning from Settings > Cellular > Add eSIM > Use QR Code, or with the Camera app. Apple notes that when the Camera app recognises an eSIM code, a Cellular Plan Detected notification appears for you to tap.
  2. Show the code full size on a second screen and turn that screen's brightness up. Glare, a cracked screen or a tiny code in an email preview can stop the camera reading it.
  3. If the code is on the iPhone itself, Apple's guide says that on iOS 17.4 or later you can tap and hold a QR code in the default mail app or a browser, then tap Add eSIM. If that option does not appear, use Enter Details Manually with the details in your plan instructions.
  4. Check you are on Wi-Fi. The camera can read the code, but the profile still has to download.

Do not keep rescanning the same code on different phones to "test" it. Many travel profiles can be installed only once.

"Cellular Plan Cannot Be Added" or "Unable to Complete Cellular Plan Change"

What it usually means: the download did not finish, the iPhone is locked to a carrier, or the code has already been used.

What to do:

  1. Check the connection. Switch to a stronger Wi-Fi network. Hotel and airport Wi-Fi with a sign-in page often blocks the download until you have signed in.
  2. Check the lock. Go to Settings > General > About and look at Carrier Lock. "No SIM restrictions" means the iPhone is unlocked. Apple states that to use two different carriers on Dual SIM, your iPhone must be unlocked.
  3. Check whether it installed anyway. Open Settings > Cellular. If a new line appears under SIMs, the profile is already on the phone, even if the message said otherwise.
  4. Stop and contact support if none of that explains it. Send your order email, device model and a screenshot of the message. Do not buy a second plan until support has checked the first one.

The eSIM is installed but there is no data

What you see: the line appears in Settings > Cellular, but web pages do not load, or the status bar shows No Service, Searching or SOS.

Apple explains that "No Service" or "Searching" means the iPhone is not connected to a cellular network. Work through this list, checking the status bar after each step:

  1. Are you in a covered country? Many plans connect only once you are inside the plan's coverage area, so at home the line may show no service. That is normal.
  2. Is the line turned on? Tap the travel line in Settings > Cellular. If you see Turn On This Line, tap it.
  3. Is it the data line? Settings > Cellular > Cellular Data must point to the travel line.
  4. Is Data Roaming on for the travel line? See the next section.
  5. Toggle airplane mode on and off, then wait a few minutes.
  6. Turn the line off and on again. Apple's troubleshooting article suggests this if the line is shown in Settings > Cellular.
  7. Restart the iPhone.
  8. Check for a carrier settings update. On Wi-Fi, open Settings > General > About. If an update is available, a prompt appears.
  9. Try manual network selection. Tap the travel line > Network Selection, turn off Automatic and choose a listed network.

Data Roaming is off, or on for the wrong line

This is the most common reason a working eSIM shows no data. Travel eSIMs connect through partner networks, so the phone treats your travel line as roaming even though you bought it for that country.

  • Travel line: Settings > Cellular > tap the travel line > Data Roaming on.
  • Home line: Settings > Cellular > tap your home line > Data Roaming off.

Apple's own cellular data guide says that if you have an international data plan you may need to keep Data Roaming on, and that turning it off on your carrier's line avoids roaming charges. Those two settings together give you local data on the eSIM without your carrier billing you for data.

Allow Cellular Data Switching is on

Apple describes this setting as letting the iPhone use either line depending on coverage and availability. On a trip that is the opposite of what you want, because a weak moment on the eSIM can push data onto your home line. Turn it off in Settings > Cellular > Cellular Data.

The plan instructions show an APN

Most eSIM profiles set the APN automatically. If your plan details list one, open the travel line > Cellular Data Network and type it exactly as written, keeping the same capitals and dots. Leave username and password blank unless your instructions include them. After any APN change, turn mobile data off and on, or restart the phone. Our Help Center article on APN settings has the same steps for Android. If you do not see Cellular Data Network at all, the profile manages the APN for you and you can skip this step.

What to send support if it still fails

Support can help much faster with the right details. Gather:

  • your order email and destination;
  • your iPhone model and iOS version (Settings > General > About);
  • your EID, also listed under Settings > General > About, which identifies the eSIM in your phone;
  • the exact error message, as a screenshot;
  • a screenshot of Settings > Cellular showing both lines.

Apple's troubleshooting page recommends noting the error message and your IMEI or EID before you contact anyone, and the same list works for us.

Dual SIM details worth knowing on iPhone

A travel eSIM turns your iPhone into a Dual SIM phone for the trip. Apple's Use Dual SIM on iPhone guide lists a few behaviours that surprise people:

  • Which models do what. One physical SIM plus one eSIM works on iPhone XR, XS and later. Two eSIMs at once work on iPhone 13 and later and iPhone SE (3rd generation). Apple also notes that physical SIM is not supported on all models, so on some iPhones both lines are eSIMs.
  • Personal Hotspot uses the data line. If you share data with a laptop, it comes from whichever line is selected for Cellular Data. Whether hotspot is allowed depends on the plan; see eSIM hotspot.
  • Calls during calls. If you are on a call on one line, calls to the other line may go to voicemail unless Wi-Fi Calling is on for that line.
  • Messages stay on their line. An SMS conversation started on one line cannot be switched to the other.
  • Labels show in your apps. The Cellular Plan Label you chose appears in Phone, Messages and Contacts, which is why a clear name such as "eSIMer Travel" helps.

To make data last, you can also turn on Low Data Mode for the travel line only: Settings > Cellular > tap the line > Low Data Mode. Apple says this pauses automatic updates and background tasks, and reduces streaming quality.

Keeping your number while you travel

Your iPhone can keep your home line active for calls and texts while the eSIM handles data. iMessage and FaceTime can stay tied to your normal number. WhatsApp keeps working on your existing account, because it uses data, not the SIM.

eSIMer plans are data-only, so the travel line has no local number or SMS. See dual SIM eSIM travel for the full two-line setup.

After the trip

When the plan ends, switch Cellular Data back to your home line and turn the travel line off. You do not have to delete it straight away. If you do want to remove it, read delete eSIM first, because a deleted profile usually cannot be reinstalled.

eSIMer features

As described on esimer.io and in the eSIMer listings on the App Store and Google Play (features can change):

  • Plans for many destinations, by country, by region, daily unlimited and high data.
  • Buy on the web, manage in the app on iPhone and Android.
  • QR code install from the website or the app, with no physical SIM.
  • Usage tracking: see your remaining data, plan details and validity in the app.
  • eSIMer Wallet to add balance and pay for plans.
  • Top-up on supported plans, without installing a new eSIM.
  • Data-only plans, so your home number stays on your own SIM.
  • Support at support@esimer.io and in the Help Center.

Plans

Choose from country plans, regional plans, daily unlimited plans and high-data plans on the eSIMer data plans page. Each plan page lists coverage, plan type, the activation window and the data options with their validity. Check the current price on the data plans page or in the eSIMer app on Google Play or the App Store.

Best for

This setup is best for iPhone users who:

  • want data ready the moment they land;
  • want to keep their home number for calls and bank texts;
  • prefer to install at home on Wi-Fi rather than at the airport.

Frequently asked questions

Can I install the eSIM if the QR code is on my iPhone?

You cannot point the camera at its own screen. Open the code on another device, use the tap-and-hold option described above on iOS 17.4 or later, or choose Enter Details Manually with the details from your plan instructions.

Does iPhone show how much eSIM data I have left?

iOS shows how much data each line has used in Settings > Cellular, but not the remaining allowance of your plan. The eSIMer app tracks your usage and validity in real time.

Can I install the eSIM on an iPad instead?

If the iPad supports eSIM and cellular data, the steps are similar, under Settings > Cellular Data. Many travel eSIM profiles can be installed only once, so choose the device before you scan.

How many eSIMs can my iPhone hold?

Apple says an iPhone can store eight or more eSIMs, but only two lines can be active at the same time. You can keep an old travel eSIM switched off and still add a new one for your next trip.

Set up your iPhone eSIM now

Pick your destination on the eSIMer data plans page or download the eSIMer app, then install your eSIM on Wi-Fi before you fly.

← All posts