Applies to: iPhone 15 / 16 / 17 series; some international iPhone 14 SKUs. Mainland iPhone 16 Pro / 17 Pro have eSIM disabled at the hardware level and cannot be activated; only the iPhone 17e is part of the domestic pilot.

1. Before you start: which model do you have?

Variant eSIM hardware Chinese carriers Roaming eSIM
Mainland (CH) ❌ Mostly disabled; 17e pilot only Pilot only ❌
Hong Kong / Macau ✅ Physical + eSIM dual Works ✅
International / US ✅ Dual eSIM ❌ ✅

To check: Settings → General → About → Model. Suffix CH = mainland; ZA/ZP = HK/Macau; LL = US; J/A = Japan.

Or dial *#06# — if you see IMEI 1, IMEI 2, and an EID, the hardware supports dual eSIM.

2. International / Hong Kong: scan-and-download (most common)

When: you bought a roaming eSIM from Airalo / Nomad / Holafly or similar.

  1. Do the following on Wi-Fi, before you fly.
  2. Open the QR code from the provider email (or grab the LPA string).
  3. iPhone: Settings → Cellular → Add eSIM → Use QR Code → scan with the camera.
  4. After a few seconds you'll see "Activate Cellular Plan" — tap Continue → Add Cellular Plan.
  5. Name the line (e.g. "Japan Data") and pick the default line (keep your original number as the primary, with the new eSIM for data).
  6. Critical: in Cellular Data, pick the new eSIM as the data line, otherwise after landing your primary number will rack up roaming charges.

Gotcha 1: many people assume metering starts when you scan. In reality most providers only start the clock when you attach to a destination base station — so it's safe to download the profile before departure, just leave the line off.

Gotcha 2: if scanning fails, use Enter Details Manually and paste the LPA string from the email (looks like LPA:1$smdp.io$XXXXXXXX).

3. Hong Kong iPhone: dual eSIM + physical SIM three-line setup

The Hong Kong iPhone is the most flexible configuration:

  • 1 physical SIM tray
  • Multiple eSIM profiles downloaded, one or two active at a time

Real-world setup:

  • Physical SIM: HK number / mainland number
  • eSIM 1: roaming eSIM (turn on during trips)
  • eSIM 2: secondary number (for verification SMS)

To switch: Settings → Cellular → tap the line → toggle Turn on this line.

4. Mainland iPhone 17e: China's first consumer eSIM pilot

This pilot opened in late 2025 and currently applies to only the iPhone 17e as a mainland model.

Activation flow:

  1. Install the China Unicom, China Mobile, or China Telecom app.
  2. Go to home → eSIM (in some provinces it's under "5G / Service").
  3. KYC: facial recognition + ID card scan.
  4. Pick a plan (usually shared with physical-SIM plans).
  5. After receiving the QR, on iPhone: Settings → Cellular → Add eSIM, scan, and download.
  6. Done.

Provincial coverage as of Q1 2026: Beijing, Shanghai, Guangzhou, Shenzhen, Hangzhou, Chengdu, Wuhan, Nanjing, Suzhou and other tier-1 / strong tier-2 cities are live; others are coming.

5. International iPhone in mainland China

International iPhones cannot directly activate the three Chinese carriers' eSIM in mainland China (true for UK, JP, US — all of them), but you can:

  • Insert a Chinese physical SIM in the tray (mainland iPhone 15+ all have a physical tray, except US).
  • US iPhone: with no physical tray, use a "physical-to-eSIM chip" or fall back to Apple Watch eSIM.

6. Common error codes and fixes

  • "Cannot add cellular plan" → most likely the model doesn't support eSIM. Double-check on the compatibility list.
  • "QR code already used" → the eSIM was already downloaded (by you or someone else). Ask the provider to reissue.
  • "Invalid activation code" → check the LPA string is complete (with the LPA:1$ prefix).
  • "No service" → first activation after landing — go to Control Center → Cellular and pick the new line. If still no service, reboot once.
  • "Awaiting activation" for over 10 minutes → toggle airplane mode → restart → reselect carrier.

7. Dual-line management tips

  • iMessage / FaceTime: can be bound to multiple numbers — only tick your primary to avoid getting hit with spam SMS while abroad.
  • Default SIM: iOS 18+ lets iOS remember the default SIM per contact — set it when you create the contact.
  • Data line switching: long-press the "Cellular Data" tile in Control Center to switch in one tap.

8. Monitoring usage after activation

Roaming eSIMs are usually billed by "day" / "GB". Two ways to keep an eye:

  • iOS built-in: Settings → Cellular → tap the line → see current-period usage.
  • Provider app: Airalo / Nomad both have official apps with live balance and expiry.

9. Removing or migrating

  • Remove eSIM: Settings → Cellular → tap the line → scroll down → Remove Cellular Plan.
  • New iPhone: Setup Assistant offers to Transfer eSIM to the new device — takes seconds, number stays the same.

10. Want a quick verdict?

Tap AI advisor at the top of any page and tell it the exact iPhone variant and destination — the AI will spit out a step-by-step activation checklist.

Related reading