← All articles

How to Install an eSIM on iPhone and Android: QR Code, Quick Install, and Manual Setup

Step-by-step eSIM installation for iPhone, Google Pixel, and Samsung Galaxy using a QR code, a quick-install link, or manual activation codes, plus fixes for the most common setup problems.

Installing an eSIM takes about two minutes when everything is ready, and much longer at an airport gate when it isn’t. This guide walks through each install method on iPhone and the main Android phones, then covers the problems that come up most often.

The steps use Agora Telecom as the example, which offers Quick Install, QR code, and manual installation. The same steps work for most eSIM providers.

Before you start: three checks

1. Your phone supports eSIM. Most iPhones from the XS and XR onwards, Google Pixel phones from the Pixel 3 onwards, and recent Samsung Galaxy S, Z, and many A-series models do. Some regional versions don’t. Dial *#06#: if you see an EID number, the phone has eSIM hardware.

2. Your phone is not carrier-locked. A phone bought on contract may only accept SIMs from that carrier. If you are unsure, ask your carrier whether the device is unlocked.

3. You are on stable Wi-Fi. The phone downloads the eSIM profile during installation. Do this at home or in a hotel, not on unreliable airport Wi-Fi.

Method 1: Quick Install

Quick Install is the fastest option when you are reading the eSIM details on the same phone you want to install it on. Instead of scanning a code, you tap an install link or button and the phone opens its own eSIM setup screen.

  1. Open your eSIM details on the phone that will use the eSIM.
  2. Tap the Quick Install option.
  3. Confirm when the phone asks to add the cellular plan.
  4. Give the line a label such as “Travel” so you can tell it apart from your main SIM.

Recent iOS versions support this kind of link-based install. If your phone does not react to the link, use the QR code or manual method.

Method 2: QR code

Use this when the QR code is displayed on another screen, such as a laptop, a tablet, or a printout.

iPhone

  1. Go to Settings > Cellular (or Mobile Data).
  2. Tap Add eSIM or Add Cellular Plan.
  3. Choose Use QR Code and scan it.
  4. Follow the prompts, label the line, and choose how to use it for now. Keeping your main line as the default is fine until you arrive.

Google Pixel and most Android phones

  1. Go to Settings > Network & internet > SIMs.
  2. Tap Add SIM or +, then Download a SIM instead or Use an eSIM.
  3. Scan the QR code and confirm.

Samsung Galaxy

  1. Go to Settings > Connections > SIM manager.
  2. Tap Add eSIM.
  3. Choose Scan QR code from service provider and scan it.

Menu names vary slightly between Android versions and manufacturers, but the path always runs through the SIM or mobile network settings.

Method 3: Manual entry

If you can’t scan the code, perhaps because the only copy is on the phone itself, enter the details by hand. You need two values from your eSIM details:

  • the SM-DP+ address, a server address
  • the activation code

On iPhone, choose Enter Details Manually on the Add eSIM screen. On Android, look for Enter code manually or Need help? on the scan screen. Copy the values exactly. They are case-sensitive, and an extra space will stop the install.

After you arrive: turning it on

Installation and activation are separate steps. Once you land:

  1. Turn on the eSIM line in your SIM settings.
  2. Set the eSIM as the line for mobile data.
  3. Turn on data roaming for the eSIM line. Travel eSIMs usually connect to partner networks, so they register as roaming even in the destination country.
  4. Keep your home SIM for calls and texts if you want, but turn off data roaming on it to avoid charges from your home carrier.

On iPhone this is under Settings > Cellular, by tapping each line. On Android, look for SIM manager or SIMs and the mobile data preference.

When does the plan start?

That depends on the plan. Some start when the eSIM first connects in a covered country; others have different rules. Non-expiring plans don’t have a validity window at all. Check the plan details before installing, and if in doubt, leave the line switched off until you arrive. Our non-expiring eSIM guide explains how those plans differ.

Troubleshooting

ProblemWhat to try
“Unable to add eSIM” or code rejectedCheck Wi-Fi, check the phone is unlocked, re-enter manual codes carefully
Installed, but “No Service”Turn on data roaming for the eSIM line; select it for mobile data
Signal bars but no internetToggle airplane mode; check the APN if the provider gave one
Works in one country, not anotherConfirm the country is covered by your plan
Data used upTop up the same eSIM; Agora Telecom says every eSIM can be reloaded

Do not delete the profile

Removing an eSIM profile is easy and usually permanent. Most profiles can’t be downloaded a second time. If you no longer want the line active, turn it off instead of deleting it, especially if the plan still has data or can be topped up. If you have already deleted it, contact support. Agora Telecom offers support through Telegram.

Privacy reminder

Agora Telecom asks only for a username and password to register. Once installed, your eSIM connects to mobile networks like any SIM, and those networks see the connection. Our private travel eSIM guide covers the habits that make the biggest difference.

Find a plan at Agora Telecom.

Frequently asked questions

How do I know if my phone supports eSIM?

On iPhone, look for Add eSIM or Add Cellular Plan under Settings > Cellular (Mobile Data). On Android, look for an option to download or add an eSIM under SIM settings. You can also dial *#06# and check for an EID number, which eSIM-capable phones display.

Should I install my travel eSIM before I leave?

Yes. Install it at home over Wi-Fi, then leave the eSIM line switched off until you arrive. Check the plan details for when validity starts.

Why does my eSIM show no service after installation?

The most common causes are data roaming being off for the eSIM line, mobile data still set to your home SIM, or being in a country the plan does not cover. Turn on roaming for the eSIM line and select it for mobile data.

Can I reinstall an eSIM after deleting it?

Usually not. Most eSIM profiles can be installed only once. Contact the provider's support before deleting a profile you may still need.