How to Install eSIM on iPhone:
3 Methods + Fix Every Error
QR code, manual entry, or one-tap app install — three ways to get your eSIM running on iPhone in under 5 minutes. Plus every error explained and fixed.
Installing an eSIM on iPhone takes under 5 minutes when you know the steps. The most common reason it fails is skipping one small setting after installation — Data Roaming. This guide walks through all three installation methods and every error you might hit along the way.
Before You Start: Check Compatibility
All iPhones from XS and XR (2018) onwards support eSIM. The quick check: go to Settings → Cellular and look for an Add eSIM button. If it’s there, you’re good. Two things also need to be true:
Need a travel eSIM first?
Airalo covers 200+ countries from $3.50. Install takes 3 minutes after purchase.
Method 1: QR Code (Most Common)
This is how 95% of travel eSIM installations work. Your provider emails you a QR code after purchase. You scan it with your iPhone camera or in Settings. The whole process takes under 3 minutes.
Works with Airalo, Holafly, Saily, Nomad, Jetpac, and most providers. You’ll need the QR code on a separate screen (another device, a printout, or someone holding their phone up) since your iPhone’s camera needs to scan it.
Open Settings and go to Cellular
Tap Settings → Cellular (or Mobile Service in some regions).
Tap “Add eSIM”
You’ll see this at the top or bottom of the Cellular screen. On iOS 16 and earlier it may say “Add Cellular Plan.”
Select “Use QR Code”
Your iPhone camera opens. Hold it steady over the QR code from your provider. The code scans automatically — you don’t tap anything.
Tap “Continue” when prompted
A “Cellular Plan Detected” notification appears. Tap it, then tap Continue. Your iPhone downloads the eSIM profile — takes 30–60 seconds on good Wi-Fi.
Label the plan
iPhone asks you to give the new line a label. Name it something clear — “Travel Data”, “Airalo Japan”, or similar. This helps you identify it in Settings later.
Set your default lines
iPhone asks which line to use for calls, iMessage, and data. Keep your primary SIM for calls. Set your travel eSIM as “Primary” for cellular data only — you’ll switch this after you land.
Tap “Done”
Your eSIM is installed. It will appear in Settings → Cellular as a separate line. It’s ready — it will activate automatically when your phone connects to the destination network.
Method 2: App Install (One-Tap)
Several major providers — including Airalo, Holafly, Saily, and Nomad — let you install your eSIM directly from their iPhone app with a single tap. No QR code needed. This is the fastest method when it’s available.
Only works if your provider has an iOS app that supports direct installation. Airalo’s app is the most polished — purchase and install happen in the same flow without leaving the app.
Download your provider’s app
Get the Airalo, Holafly, Saily, or Nomad app from the App Store. Log in to your account.
Purchase your plan in the app
Choose your destination and data amount, pay in-app. After purchase, your eSIM appears under “My eSIMs.”
Tap “Install” or “Activate”
The app prompts you to install the eSIM directly. Tap Install — iPhone shows a confirmation dialog. Tap Allow to proceed.
Follow the label and line prompts
Same as Method 1 — label your plan and set your default lines. Your home SIM stays as the call line; set the eSIM as data for travel.
Done — check in Settings
Verify in Settings → Cellular that the new plan appears. It’s installed and ready to activate on arrival.
Method 3: Manual Entry (Fallback)
Use this if the QR code won’t scan — for example if you only have the eSIM details as text in an email, or if your camera is struggling. Your provider will give you two codes: an SM-DP+ address and an activation code.
Slower than QR or app install, but always works. Copy the SM-DP+ address and activation code from your provider’s email carefully — a single wrong character will fail the install.
Go to Settings → Cellular → Add eSIM
Follow the same path as Method 1 up to the QR scan screen.
Tap “Enter Details Manually”
This appears below the QR scanner. Tap it to open the manual entry form.
Enter your SM-DP+ address and activation code
Copy these exactly from your provider’s email — use copy-paste if possible, don’t type manually. The SM-DP+ address looks like a web URL. The activation code is a string of letters and numbers.
Tap “Next” and wait
iPhone connects to the carrier’s server to verify and download your profile. This can take up to 2 minutes. Stay on Wi-Fi.
Label and configure as before
Follow the same label and default line prompts as Methods 1 and 2.
After Installation: Dual SIM Setup
With your eSIM installed alongside your home SIM, you need to configure which line does what. This is where most first-timers get confused — the right setup keeps your home number reachable while the eSIM handles all data.
Select your home SIM. Your number stays reachable for calls and texts even while abroad.
Select your travel eSIM. This ensures all browsing, maps, and apps use your travel plan, not expensive roaming.
Toggle this ON. Without it, your eSIM shows as installed but passes no data. This is the #1 cause of “eSIM not working” reports.
Turn this OFF. Keeps your home SIM on for calls but prevents it from pulling data and racking up roaming fees.