Need help setting up an eSIM on my iPhone

General
1

I just switched carriers and they gave me an eSIM instead of a physical SIM, but I’ve never used an eSIM before. I’m not sure where to start, what settings to check, or if I need a QR code or activation code from my carrier. Can someone walk me through the correct steps to set up an eSIM on an iPhone so I don’t mess anything up or lose service?

2

Heres the simple version for iPhone eSIM.

  1. Check basics
    • iPhone XR or newer, or XS / XS Max or newer
    • iOS up to date
    Settings > General > Software Update

  2. Get what you need from carrier
    Ask them:
    • Do you support eSIM on iPhone
    • Do you use QR code, activation code, or automatic activation
    You usually need at least one of these:
    • QR code
    • SM-DP+ address and activation code
    • A text link or app from the carrier

  3. If you have a QR code
    • Go to Settings > Cellular (or Mobile Data)
    • Tap Add eSIM or Add Cellular Plan
    • Point your camera at the QR code
    • Tap Add Cellular Plan
    • If it asks for a confirmation code, your carrier gives that

  4. If you have an activation code (SM-DP+ etc)
    • Settings > Cellular > Add eSIM
    • Tap Use QR Code
    • At bottom tap Enter Details Manually
    • Type the SM-DP+ address and activation code from the carrier

  5. If they say “it should auto install”
    • Make sure Wi‑Fi is on
    • Settings > Cellular > Add eSIM
    • Tap “Transfer from Nearby iPhone” if you are moving from old iPhone with same carrier
    Or
    • Tap “Use Carrier Activation” if it shows up
    Follow the prompts

  6. Set as main line
    After it installs, iPhone asks:
    • Set as Primary or Secondary line
    If this is your only number, choose Primary
    Then go to:
    • Settings > Cellular
    Tap your new plan
    Turn on “Turn On This Line”
    Turn on Data Roaming only if your plan supports roaming

  7. Turn off your old SIM
    If you had a physical SIM before:
    • Settings > Cellular
    • Tap the old plan
    • Turn off “Turn On This Line”
    You can remove the old SIM tray card after that

  8. Check it works
    • Signal bars show your new carrier
    • Try a call
    • Turn off Wi‑Fi and see if mobile data works
    If data fails, go to Settings > Cellular > your new plan > Cellular Data Options > Voice & Data, pick LTE or 5G as your plan supports

  9. Common issues
    No service:
    • Airplane Mode off
    • Restart iPhone
    • Settings > General > About, wait a bit, it might prompt Carrier Settings Update

QR not working:
• Clean the camera lens
• Ask carrier to email a new QR or give you manual SM-DP+ details

If you post your iPhone model and what the carrier gave you (QR, code, or nothing), people here can point to exact taps.

3

Big thing I’d add on top of what @viajantedoceu said is to figure out what exactly your carrier already did to your line before you start tapping around. A lot of people skip that and get stuck in a weird half‑activated state.

Here’s how I’d tackle it without rehashing all the same steps:

  1. Check if the eSIM is secretly already installed

Sometimes carriers push the eSIM over the air and never say it clearly.

  • Go to:
    Settings > Cellular (or Mobile Data)
  • Look under “Cellular Plans”
    • If you already see your new carrier name there, tap it.
    • Make sure Turn On This Line is enabled.
    • If that works, you might not even need a QR or code.

If you only see your old carrier, then yeah, you still need to add it manually.

  1. Figure out what the carrier actually gave you

You said “they gave me an eSIM” but that can mean 3 different things:

  • A printed QR code
  • An email with a QR or SM‑DP+ address / activation code
  • A “we’ll activate it automatically” promise which may or may not be actually done

If they did not hand you anything, check your email / SMS from them. A lot of carriers hide the real activation data in some boring looking message.

  1. If they claim “no QR needed”

This is where I slightly disagree with the idea that you always “need at least QR / SM‑DP+ / link.” Some US carriers really do a pure carrier activation. In that case:

  • Connect to Wi‑Fi
  • Settings > Cellular > Add eSIM
  • If you see Use Carrier Activation or something with your new carrier name, use that.
  • If you see nothing carrier related and it just wants a QR, then they did not actually provision your line correctly and you need to bug them again.
  1. Make sure you’re not fighting the old SIM

If you had a physical SIM before and you leave both active, iOS sometimes routes calls or data over the wrong line and it looks “broken.”

  • Settings > Cellular
  • Under “Cellular Plans,” tap the old carrier
  • Temporarily toggle Turn On This Line off
  • For now, also make sure under:
    • Cellular Data: set to the new eSIM
    • Default Voice Line: set to the new eSIM

You can always re‑enable the old one later if you want dual SIM.

  1. Check the two sleeper settings that mess people up

If you see signal bars but data does nothing:

  • Settings > Cellular > [your new plan] > Cellular Data Network
    • Some carriers need APN to be set. If this screen is empty and data is dead, call or chat with them for APN values.
  • Settings > Cellular > [your new plan] > Voice & Data
    • Try switching between 5G Auto / LTE to see if one of them actually works. Some plans say “5G” in ads but are really LTE only.
  1. What to ask your carrier if you contact them

Instead of “I can’t get my eSIM to work,” say something precise:

  • “Can you confirm my line is provisioned for eSIM on iPhone specifically?”
  • “Can you resend my eSIM QR or the SM‑DP+ address and activation code?”
  • “Is this line activated yet, or is it still pending?”

Half the time, the issue is that they created the eSIM profile but never toggled the line to active on their side.

  1. If nothing appears under Add eSIM

If:

  • Settings > Cellular > Add eSIM only shows the QR screen
  • And the carrier says “it should just work, no QR needed”

Then someone on their end messed up the activation profile. iOS can’t invent an eSIM profile out of thin air. In that case, ask them explicitly:

“Please either send me a QR code or give me the SM‑DP+ address and activation code for manual eSIM setup.”

Last quick sanity checks:

  • Airplane mode off
  • iPhone restarted once after adding the eSIM
  • iOS updated
  • Region is not set to something weird that limits carriers

If you want super targeted steps, post which iPhone model you have and exactly what the carrier gave you: paper QR, PDF, just a text, or literally nothing but “you’re good to go.” The answer changes a lot depending on that.