Why You Must Set Up Your China eSIM Before Landing#
Here’s the single most important thing in this entire guide: install your China eSIM before you land.
Not at the airport. Not at your hotel. Not “I’ll figure it out when I get there.” Do it at home, before you board your flight.
Why? China’s internet infrastructure blocks eSIM profile downloads from inside the mainland. The geolocation check happens on the eSIM provisioning servers — not on your phone — and there’s no workaround once you’re physically in China. If you try to download your eSIM profile from a Beijing hotel room, it simply won’t connect.
If you’ve already landed without installing it, your best bet is connecting to airport WiFi during a layover in Hong Kong, Tokyo, Seoul, or any other city outside mainland China. Download and install the profile there before your final flight into China. It’s not ideal, but it works.
The good news? Once your eSIM profile is installed, everything runs smoothly. Most China travel eSIMs route your traffic through servers outside the mainland, which means they automatically bypass the Great Firewall. Google, WhatsApp, Instagram, YouTube — they all just work, no separate VPN needed.
This guide walks you through the entire setup process for both iPhone and Android, including QR code scanning, APN settings, dual-SIM configuration, and the most common error messages people hit (and how to fix them).
If you haven’t picked a provider yet, start with our best eSIM for China buying guide — we compare pricing, data allowances, and coverage across all the major options.
Check Your Phone First: Compatibility and Unlock Status#
Before you buy anything, make sure your phone can actually use an eSIM. This takes two minutes and saves a lot of headaches later.
Step one: check for eSIM hardware. Open your phone app and dial *#06#. You’ll see your device info — look for a 32-digit EID number. If it’s there, your phone has eSIM support. If you only see an IMEI number and nothing else, your phone doesn’t support eSIM.
Step two: check carrier lock status. Even if your phone supports eSIM, it won’t work if it’s locked to a specific carrier. This is common with phones bought on installment plans in the US. Contact your carrier and request an unlock — it’s usually free, but can take 1–3 business days to process. Don’t leave this to the last minute.
⚠️ CRITICAL WARNING for travelers buying phones in Asia: iPhones sold in mainland China, Hong Kong, and Macau do not have eSIM hardware at all — they use dual physical nano-SIM slots instead. If you’re planning to pick up a cheap iPhone in Hong Kong before crossing into Shenzhen, it won’t work with any eSIM.
Quick compatibility reference:
- iPhones: XS, XS Max, XR, and all newer models support eSIM (as long as they weren’t sold in China/HK/Macau)
- Samsung Galaxy: S20 series and newer (S20+, S20 Ultra, S21 and up)
- Google Pixel: Pixel 4 and newer
Not sure about your specific model? Check our full phone compatibility guide — it covers every supported device, region-specific quirks, and what to do if your phone isn’t on the list.
Pro tip: Do this compatibility check at least a week before your trip. If you need to get your phone unlocked — or realize you need to borrow a different phone — you’ll want that buffer time.
How to Install a China eSIM on iPhone#
Alright, you’ve got your eSIM and you’re ready to install. The whole process takes about two minutes. Here’s exactly what to do:
Step 1 — Get your QR code ready. Open your provider’s app or check the confirmation email. You’ll need either a QR code or a manual activation code (sometimes both).
Step 2 — Go to Settings → Cellular (or Mobile Data) → Add eSIM (on older iOS versions, it may say “Add Cellular Plan”).
Step 3 — Tap “Use QR Code” and point your camera at the QR code on your screen or a printed copy. Your phone will recognize it instantly.
Step 4 — Label the new plan. When prompted, name it something obvious like “China Data” or “China eSIM.” This helps you identify it later when you’re managing dual SIM settings.
Step 5 — Choose “Do Not Use” or “Secondary.” This is important. You want to keep the eSIM turned off until you actually land in China. If you activate it at home, it may conflict with your regular carrier plan or start consuming your data allowance before your trip even begins.
Step 6 — Screenshot the QR code and save your manual activation code. This is your backup. If anything goes wrong and you need to re-install the eSIM profile, you’ll need these. Store them somewhere accessible — your photos app, a notes folder, or even email them to yourself.
Where to find your QR code depends on your provider:
- Holafly sends the QR code and a manual activation code via email after purchase
- Airalo displays the QR code directly in their app, and also emails it as a backup
- Saily sends everything through email — check your spam folder if you don’t see it
One last thing: installation requires a WiFi connection. The profile download is small, but it needs internet access to complete. Do this at home on your own WiFi — not at the airport on spotty public WiFi. Get it done the night before your flight, and you’ll land in China with data ready to go.
How to Install a China eSIM on Android#
Installing an eSIM on Android is straightforward, but the exact menu path depends on who made your phone. Don’t worry — the end result is the same regardless of whether you’re using a Pixel, Samsung, or Motorola.
Step 1: Get Your QR Code Ready#
After purchasing your China eSIM, your provider will send a QR code either inside their app or via a confirmation email. Pull that up on a second device (laptop, tablet, or a friend’s phone). You’ll need to scan it with your Android phone, so don’t try to photograph your own screen — that never works well.
Step 2: Find the Right Menu#
This is where things differ slightly by brand:
- Google Pixel: Settings → Network & Internet → SIMs → tap the "+" button
- Samsung Galaxy: Settings → Connections → SIM card manager → Add mobile plan
- Motorola (and most others): Settings → Network & Internet → SIMs → “Download a SIM instead”
Pixel has the cleanest, most direct menu. Samsung tucks it behind an extra “Connections” layer, but it’s still easy to find.
Step 3: Download the eSIM#
Choose “Download a SIM instead” or “Set up an eSIM.” Then point your camera at the QR code on your second device. The phone will recognize it and begin the download automatically.
Step 4: Confirm and Label#
After the download completes, rename the new eSIM to something like “China Data” so you can easily identify it later.
Step 5: Keep It Disabled for Now#
When prompted to activate, say no. You want it installed and ready, but turned off until you actually land in China.
Important: The entire installation process requires a WiFi connection. Make sure you’re connected to stable WiFi before you start — the download typically takes 10–30 seconds.
What to Do Right After Landing in China#
You’ve touched down, the seatbelt sign is off, and you’re taxiing to the gate. This is the moment. Here’s exactly what to do — in order — to get connected before you even reach baggage claim.
1. Turn On the China eSIM Line#
Go to your SIM settings and enable the China eSIM. On iPhone: Settings → Cellular → toggle the China line on. On Android: Settings → Network & Internet → SIMs → activate it.
2. Set It as Your Primary Data Line#
Make sure your phone knows to use the China eSIM for internet — not your home SIM. On iPhone: Settings → Cellular → Cellular Data → select “China Data.” On Android: Settings → SIMs → Mobile data → choose the China eSIM.
3. Turn ON Data Roaming for the eSIM#
This is the #1 reason travelers think their eSIM is broken. Most China eSIMs work by roaming onto local networks like China Unicom or China Mobile. If Data Roaming is off for the eSIM line, you’ll have zero internet — period. Turn it ON.
4. Turn OFF Data Roaming for Your Home SIM#
At the same time, make sure Data Roaming is disabled for your original SIM. This prevents your home carrier from sneaking in background data and hitting you with a surprise $50 charge.
5. Wait 30–60 Seconds#
Give the phone a moment to register on the local network. You’ll typically see the signal bars populate and a carrier name appear (often “China Unicom” or “CMCC”).
6. Test It#
Open your browser and go to google.com or whatsapp.com. It should load immediately. Most quality China eSIMs include automatic GFW bypass, so WhatsApp, Google, Instagram, and YouTube should all work out of the box.
No signal after 60 seconds? Toggle Airplane Mode ON, wait 10 seconds, then turn it back OFF. This forces your phone to reconnect to nearby cell towers and almost always resolves the issue.
APN Configuration (When Auto-Setup Fails)#
Most of the time, your China eSIM will configure itself automatically. But occasionally you’ll see full signal bars and a carrier name — yet no internet. When that happens, the APN (Access Point Name) is almost always the culprit.
The APN tells your phone how to route data through the carrier’s network. If it’s blank or wrong, your phone is connected to the tower but has no idea where to send traffic.
How to Check and Fix APN#
iPhone: Settings → Cellular → Cellular Data Network. Look at the APN field under the Cellular Data section. If it’s empty, that’s your problem.
Android: Settings → Network & Internet → Mobile Network → Access Point Names. Tap the active APN and check its value.
Where to Find the Correct APN#
Check the confirmation email from your eSIM provider — most include an APN value in their setup instructions. Common values include CMHK, 3gnet, or ims.
Enter the correct APN, leave the username and password fields blank unless your provider specifically instructs otherwise, then save. Toggle Airplane Mode on and off to force a reconnection, and test again.
For a detailed walkthrough, check our full guide: China eSIM APN settings.
Manual SM-DP+ Setup (When QR Code Won’t Scan)#
Sometimes the QR code just won’t cooperate. Maybe there’s too much glare, the email attachment didn’t load, or you cracked your camera lens. Whatever the reason, there’s a fallback: manual SM-DP+ installation.
It sounds technical, but it’s really just typing in a few values instead of scanning a code. The result is identical.
Where to Find It#
iPhone: Settings → Cellular → Add eSIM → Enter Details Manually (at the bottom of the QR scan screen).
Android: Settings → Network & Internet → SIMs → Add SIM → look for “Enter manually.”
What You’ll Need#
You’ll be asked for up to three fields:
- SM-DP+ Address — the server address that provisions your eSIM
- Activation Code — a unique string tied to your purchase
- Confirmation Code — sometimes required, sometimes optional
Your provider’s dashboard or confirmation email almost always includes these values under a section labeled “Manual Installation” or “Alternative Setup.”
Copy each value carefully (they’re case-sensitive), hit confirm, and your phone will download the eSIM profile the same way it would from a QR scan.
Managing Dual SIM Settings#
Good news — you probably don’t need to swap out your home SIM card. Most phones sold after 2018 support dual SIM mode, meaning your physical SIM and eSIM can work side by side.
The recommended setup:
- eSIM → Data (your China internet)
- Home SIM → Calls & SMS (keep your regular number alive)
On iPhone: Go to Settings → Cellular. Tap “Cellular Data” and select your eSIM. Then choose your home SIM as the default for voice and SMS.
On Android: Head to Settings → Network & Internet → SIMs. Set data to the eSIM and the rest to your home SIM.
iMessage, WhatsApp, FaceTime, and WeChat all run on data, so they automatically route through your eSIM. No extra configuration needed.
💡 Pro tip: Keep your home SIM active so you can still receive SMS verification codes from your bank, email, or other accounts. Those 2FA messages are tied to your home number.
For a deeper dive into eSIM features for China travel (phone numbers, SMS, hotspot, Alipay), check our eSIM features guide.
5 Common Setup Mistakes (And How to Avoid Them)#
These five mistakes account for nearly every “my eSIM doesn’t work” email we get.
❌ Mistake 1: Installing the eSIM after you land in China#
Many eSIM providers geoblock their activation portals — if your phone’s IP address is in China, the download simply won’t start.
Fix: Install your eSIM at home before you fly, or during a layover somewhere with unrestricted internet.
❌ Mistake 2: Forgetting to enable Data Roaming#
This is the single most common cause of “I have signal bars but no internet.” An eSIM requires Data Roaming to be turned ON to access networks outside its home region.
Fix: After activating your eSIM, confirm Data Roaming is enabled for the eSIM line. Do this before you need it.
❌ Mistake 3: Deleting the eSIM profile to “fix” problems#
Most eSIM QR codes are single-use. Once scanned, the profile can’t be downloaded again. Deleting it means buying a new eSIM from scratch.
Fix: If something’s wrong, toggle the eSIM off and on, restart your phone, or check your APN settings. Deleting should be your absolute last resort.
❌ Mistake 4: Missing or incorrect APN settings#
Full signal bars but zero data load. This usually means your phone didn’t automatically pick up the correct APN.
Fix: Manually enter the APN value from your eSIM provider’s setup email. Save, toggle airplane mode on and off, and you should be good.
❌ Mistake 5: Not backing up the QR code and activation code#
If your activation email gets buried or your phone dies — you’re stuck.
Fix: The moment you receive your QR code, take a screenshot. Save it to a cloud folder. Also copy the manual activation code. Redundancy is your friend.
For more detailed troubleshooting, visit our China eSIM troubleshooting guide. And if you haven’t purchased yet, our guide to activating your China eSIM before arriving covers the entire pre-departure process.
Pre-Trip eSIM Checklist#
Don’t leave this for departure day. Run through this list at least 48 hours before your flight — it takes maybe 15 minutes and will save you from a world of stress at the arrivals gate.
- ☐ Phone supports eSIM — Dial
*#06#and look for an EID number. No EID = no eSIM support. - ☐ Phone is carrier-unlocked — Contact your carrier to confirm, or try installing any free eSIM profile.
- ☐ eSIM purchased and QR code received — Buy from a reputable provider and make sure the confirmation email has arrived.
- ☐ QR code screenshot saved + manual activation code recorded — Screenshot to camera roll and cloud folder. Copy the manual code to your notes app.
- ☐ eSIM installed but kept OFF — Scan the QR code now, then toggle the eSIM line OFF until you land.
- ☐ APN value noted from provider — Check your provider’s setup guide for the correct APN string. Save it just in case.
- ☐ Data Roaming OFF for home SIM — Prevent accidental charges on your home plan.
- ☐ All setup done BEFORE departure day — Do it two days out so you have time to troubleshoot if anything goes sideways.
With every box checked, you’ll touch down in China with working data in under 60 seconds — just toggle the eSIM on and you’re online. No airport Wi-Fi, no SIM card hunting, no stress.
To understand what speeds and coverage you can expect once you land, see our China eSIM coverage guide. And if you’re still deciding which provider to go with, our best eSIM buying guide compares the top options side by side.