Installing an eSIM on an iPhone is genuinely one of the easiest cellular setups Apple has shipped — it's faster than inserting a physical SIM, and most of the friction happens only if you skip a step. Here's the full walkthrough, including the parts most provider emails skip.
Before you install
Three things to confirm.
iOS version. Any iPhone running iOS 12.1 or later supports eSIM, which means every iPhone on a current-ish iOS build is fine. To check: Settings → General → About → iOS Version. If you're on anything older than iOS 16, update before installing — early iOS versions had eSIM install bugs that have been resolved.
Carrier unlock status. A carrier-locked iPhone refuses any eSIM profile that isn't from its home carrier. If you're on a US carrier installment plan, check your unlock status in your carrier's app before installing. T-Mobile and Verizon unlock automatically on payoff; AT&T requires a request. Full details on the compatibility check.
Working internet connection. eSIM install downloads the profile over your existing internet. Install while you're on home Wi-Fi, not after you've landed with no data path available.
Method 1: Scan the QR code
This is the common path. Works on every iPhone that supports eSIM.
- Open the email from your provider on a second device (laptop, tablet, another phone). If the QR is on the same iPhone you're installing to, save the image to Photos and you'll scan it from there.
- On your iPhone: Settings → Cellular → Add eSIM.
- Tap Use QR Code. The camera opens.
- Point the camera at the QR code. The iPhone detects it automatically and moves to the next screen.
- Confirm the install. The profile downloads — takes 15 to 30 seconds on Wi-Fi.
- Label the line (see below — don't skip this).
- Set your default line for voice, data, and iMessage.
If the QR code is saved in your Photos on the same device, there's a small link during step 3 that says "Enter Details Manually" — instead of manual entry, you can tap the bottom-right "Use existing QR Code in Photos" or similar depending on iOS version.
Method 2: Enter details manually
When the QR won't scan, or when the provider sent you the install details as text rather than an image.
- Settings → Cellular → Add eSIM → Use QR Code → Enter Details Manually (bottom of screen).
- Paste the SM-DP+ Address your provider emailed (looks like
rsp.example.com). - Paste the Activation Code (a long alphanumeric string).
- Optionally paste a Confirmation Code if the provider issued one (most don't).
- Tap Next. The profile downloads.
The SM-DP+ address and activation code together are equivalent to the QR code — the QR just encodes both in a scannable format. Any provider that issues QR codes can provide these raw fields on request.
Method 3: Direct install (iOS 17.4+)
Apple opened a one-tap install API in iOS 17.4. Provider apps that support it can push a profile directly, no QR needed.
- Install the provider's app from the App Store.
- Log in and tap the plan you purchased.
- Tap the Install eSIM button in the app.
- iOS takes over — confirm the install.
Not every provider supports it yet. When they do, this is the fastest path. When they don't, fall back to QR (method 1).
Method 4: eSIM Quick Transfer (iOS 16+)
Moving a line from an old iPhone to a new one.
- On the new iPhone during setup (or later in Settings → Cellular → Add eSIM), choose Transfer From Nearby iPhone.
- On the old iPhone, confirm the transfer when it prompts.
- The line moves in about a minute. The old iPhone loses the line; the new one gains it.
Works for home carrier eSIM on most major US and international carriers. Support for travel eSIMs varies — some providers allow transfer, some require a fresh install on the new device.
After install: label, default lines, data roaming
This is the part most provider emails skip. Three small setup steps that save a lot of confusion.
Label the line. During install, iOS asks what to name the new eSIM. Default is "Secondary." Replace it with something specific: "Travel - Thailand" or "99esim Europe" or whatever the trip is. Over a year of travel you accumulate several eSIMs; labels are the only way to keep them straight.
Set default lines. After install, iOS presents a screen asking which line to use for Default Line (voice), Data, and iMessage/FaceTime. The setup that works for most travelers:
- Default Line (voice): your home line. Incoming calls keep reaching you.
- Data: the travel eSIM. Maps, rideshare, WhatsApp all run over the travel plan.
- iMessage & FaceTime: your home line.
Turn off Data Roaming on your home line. Settings → Cellular → (your home line) → Data Roaming → off. This prevents accidental $10/MB charges if your home carrier tries to bill for international data while you're on the travel eSIM.
Turn on Data Roaming on the travel eSIM. The travel eSIM needs Data Roaming enabled on its own line to connect to foreign towers — even though the plan you bought is for a foreign country. Apple's naming here is genuinely confusing, but it's the right toggle.
Testing the install
Before you fly, confirm the install worked.
- Settings → Cellular. Your new eSIM should be listed with its label.
- Tap the line. Confirm Turn On This Line is enabled.
- Check signal in the status bar. You won't see signal bars for the travel eSIM until you're in the covered country — that's expected.
The profile is installed and dormant. It activates on the first tower it sees in a covered country, typically within 30 seconds of airplane-mode toggling off on arrival.
If the install fails
The three common failures, in order of how often they happen:
QR already used. Each QR is single-use. If you've already scanned it somewhere, it's spent. Contact the provider for a fresh one.
No internet connection. iPhone can't download the profile with no data path. Connect to Wi-Fi first.
Phone is carrier-locked. iOS shows an error like "Cannot Add Cellular Plan." This means the device has refused the profile, not that the profile is invalid. Check your carrier's unlock status.
If you're on an iPhone without eSIM hardware (iPhone 8 or older), the Add eSIM option won't appear at all. See phone compatibility for the full list.
Buy the plan on 99esim, scan the QR, label the line, set your defaults, and you're set.