How to activate Metro by T-Mobile eSIM step-by-step
To activate your Metro by T-Mobile eSIM, you need an eSIM-compatible phone, stable Wi-Fi, and the QR code or activation code provided when you purchased the line. From Settings, you access the option to add an eSIM line or plan, scan the code, and confirm: the entire process takes just a few minutes.
If you've never activated an eSIM, the order of these steps matters: doing them out of sequence is the most common reason the process gets stuck halfway through.
- Confirm that your phone is eSIM compatible. Go to Settings and look for an "Add eSIM" or "Add cellular plan" option. If it doesn't appear, the model does not support eSIM, regardless of the carrier you use.
- Connect to a stable Wi-Fi network. Activation requires downloading the line's profile from the Metro by T-Mobile server; with limited mobile data or a weak signal, the process often fails halfway.
- Have the QR code or manual activation code ready. It usually arrives via email, text message, or is displayed in the app or on the purchase receipt.
- Go to Settings > Cellular (or Mobile Data) > Add eSIM. On iPhone, it's Settings > Cellular > Add eSIM; on Android, it's usually in Settings > Network & internet > SIMs > Download a SIM.
- Scan the QR code with your phone's camera or tap "Enter details manually" if the code arrived as text.
- Wait for the profile to download and follow the on-screen instructions. The system will ask you to choose which line to use for calls, messages, and data if you already have another active SIM.
- Restart your phone once the activation is marked as complete. This is the step most people skip and the one that most quickly resolves residual signal issues.
-
Confirm that you have signal by checking the bar icon on the screen or dialing
*#06#to verify that the eSIM serial number (EID) has been registered.
Before deleting or deactivating your old physical SIM, confirm that the eSIM already shows signal and can make a test call. If you remove the old line too early and the new eSIM has not finished activating, you will be without service until it is resolved.
If you followed these steps and it still doesn't work, do not repeat the process from scratch: there is a specific cause and it can almost always be identified in less than two minutes. The general guide for installing an eSIM serves as a reference if the problem is not specific to Metro by T-Mobile but to the phone's operating system.
What you need before you start
Before touching the QR code, make sure you have these four elements ready. Missing even one is the most common reason for activation to be interrupted halfway through.
| Requirement | Why it matters |
|---|---|
| eSIM-compatible and unlocked phone | A phone locked to another carrier may reject the eSIM profile even if the hardware supports it. |
| Stable Wi-Fi connection (not mobile data) | The eSIM profile is downloaded as a file from the carrier's server; an unstable network will cut the download short. |
| QR code or manual activation code | This is the unique identifier for your line. Without it, there's no way to link the profile to your phone. |
| Sufficient battery charge (avoid critical level) | Some operating systems block profile installation with critical battery to prevent a partial activation. |
If you are still unclear on what an eSIM is exactly and how it differs from a physical card, it's worth reviewing what an eSIM is before proceeding with activation: understanding the concept prevents confusing "activating the line" with "installing the profile," which are two distinct steps.
How to get a Metro by T-Mobile eSIM if you don't have one yet
If you haven't bought the line yet, the QR code doesn't exist, and therefore activation won't proceed. You need to purchase the plan first: this generates the activation code that you then use on your phone. The typical error is trying to "activate" something that technically hasn't been issued yet.
The general process for obtaining a carrier eSIM usually includes choosing a plan, verifying that the phone is eSIM compatible before paying (not after), and receiving the QR code by email or within the carrier's app once the purchase is confirmed. If you recently purchased the line and the code hasn't arrived, check your spam folder before assuming the process failed.
If your primary interest is to have a Metro by T-Mobile line specifically, you can review the complete purchase process in the guide on how to buy a T-Mobile eSIM.
How to activate eSIM from home, without going to a store
Activating from home is exactly the same process described above: you don't need to visit a physical store to install the eSIM profile, as long as you already have the QR code and a compatible phone. The only real reason to go to a store is when the problem isn't with your phone but with the account or line on the carrier's side.
Signs that the problem cannot be resolved from home and requires direct contact with the carrier:
- The QR code never arrived after confirming the purchase.
- The account shows the line as "pending" more than a day after payment.
- The system requests identity verification that you cannot complete online.
Outside of these three cases, the entire process—from scanning the code to having a signal—is done from your own phone, at your kitchen table, without appointments or travel.
QR code doesn't work or says it expired: what to do
A QR code that "doesn't read" is almost never a problem with the phone's camera. Before requesting a new one, check these three causes in order, which cover the vast majority of cases:
- The code has already been used. eSIM activation codes are usually single-use: if you've already tried to install it once (even if it failed halfway), the system may have already consumed it.
- The phone's date and time are incorrectly set. This is the least obvious reason and one of the most frequent: eSIM profile verification against the carrier's server depends on the phone having the correct time. If your date and time are set manually, or are out of sync, set them to automatic before reattempting; this often resolves an error that seemed to be with the QR code.
- The screen or low brightness prevents reading. If you are scanning the code from another screen (like an email open on a computer), increase the brightness and avoid reflections before assuming the code is damaged.
If you tried all three and the code still doesn't work, you most likely need the carrier to reissue a new code: re-attempting the same damaged code won't fix it. The list of common problems when using an eSIM covers other frequent errors beyond activation, such as loss of signal days after installation.
Your phone says "not compatible" with eSIM: why this happens
If a phone doesn't show the option to add eSIM in Settings, it can be due to two very different things: either the hardware genuinely doesn't support it, or it does support it but is locked by the carrier or region of purchase. It's important to distinguish between both cases because the solution is different.
| Situation | What it means | Can it be resolved by changing carriers? |
|---|---|---|
| The "Add eSIM" option doesn't appear in any menu | The phone's hardware does not include an eSIM chip | No, it's a physical limitation of the device |
| The option appears but gives an error when scanning | Usually means the phone is locked to a different carrier, or purchased outside your region | Yes, if the lock is carrier-based and not hardware-based |
| The phone is "physical SIM only" from the factory in your region | Some models sell different variants by country, even if the same model has eSIM in another market | Not applicable: depends on the exact model, not the carrier |
If you are unsure whether your specific model supports eSIM before purchasing a new line, it's advisable to first check the list of eSIM-compatible phones to avoid repeating the same problem with the next line you buy.
Activating eSIM on iPhone vs. Android: the differences
The process is practically the same on both systems, but the menu names and some details in the order of the screens change. Knowing the exact path saves time searching for the correct button.
| Step | iPhone | Android |
|---|---|---|
| Menu path | Settings > Cellular > Add eSIM | Settings > Network & internet > SIMs > Download a SIM (exact path varies by brand) |
| Scanning method | Uses the native camera from the same Settings flow | Usually asks to open the camera separately or upload the QR image |
| Choosing primary line | Defined after installing the profile, under "Default Line" | Usually defined during the process, before finishing |
| Final confirmation | An "eSIM activated" notification appears within Settings | Usually displays a system notification and updated signal icon |
If your phone is a very recent or very specific model and neither of the two flows exactly matches what you see on screen, it's a sign that the manufacturer modified the menu for that version of the operating system; the general steps (compatibility, Wi-Fi, code, restart) still apply.
How long activation takes and how to confirm you have signal
The eSIM profile installation itself takes just a couple of minutes once the QR code is scanned correctly. What can take longer is for the line to be fully active on the carrier's side, especially if it's a new line and not a migration.
To confirm that the eSIM is operational:
- Check that the signal icon on the screen shows bars, not a "no service" symbol.
- Try making a test call or sending a text message.
- Open any app with mobile data activated (and Wi-Fi off) to confirm that there is also data, not just voice signal.
- If after restarting the phone there is still no signal, turn airplane mode off and on: this forces the phone to reconnect to the network from scratch without having to reinstall the profile.
If several hours pass without a signal, even though the app or system marks the eSIM as "installed," the problem is no longer with your phone but with the line activation on the carrier's side.
When to choose a travel eSIM instead of your local carrier's
If you've come this far because you were activating your Metro by T-Mobile eSIM with an international trip in mind, it's worth making a distinction: a local carrier line like Metro by T-Mobile is intended for use within the United States, and using it for international roaming is often expensive or has data restrictions. For this, there's a different product category: the travel eSIM, designed specifically for use outside your country without relying on your main line's roaming.
The practical difference is this: you keep your Metro by T-Mobile line for calls and messages with your usual number, and you use a second eSIM solely for data while traveling, without touching your local plan. You can review the complete comparison in travel eSIM versus traditional roaming if you're unsure which one suits you best based on your itinerary.
At PuraSIM, we focus exactly on that second case: data eSIMs for travel to over 200 destinations, with activation in approximately 1 minute once the profile is installed, 180 days from purchase to activate it when you need it, and 24/7 support in all languages via email and WhatsApp if something doesn't go as expected during your trip, without depending on a physical store or business hours.
Frequently asked questions
Do I need Wi-Fi to activate my Metro by T-Mobile eSIM?
Yes, a stable Wi-Fi network is recommended instead of mobile data. The eSIM profile is downloaded as a file from the carrier's server, and an unstable connection is one of the most common reasons for the download to be cut short.
Can I activate my eSIM without going to the store?
Yes, in most cases, the entire process is done from your phone, as long as you already have the QR code and the device is compatible. You only need direct contact with the carrier if the code never arrived or the account is pending verification.
What do I do if my phone doesn't show the "Add eSIM" option?
First, check if the model supports eSIM out of the box; some phones sell different variants by region, even if the same model has eSIM in another country. If the hardware doesn't support it, no software adjustment will enable it.
Can I have my Metro eSIM and another eSIM at the same time?
It depends on the phone: many recent models support dual eSIM or one eSIM plus a physical SIM active at the same time. Check the specifications of your exact model before installing a second line to confirm that it supports dual active SIMs.
Does the Metro by T-Mobile eSIM work outside the United States?
A local carrier line is intended for use within the country where you purchased it; using it for international roaming depends on the conditions of that line and may have restrictions or additional costs. For international travel, a dedicated travel eSIM is usually the simplest option.
What happens if I change phones after activating the eSIM?
The eSIM profile is installed on the phone where you activated it; it is not automatically transferable like a physical card. If you change devices, you typically need to request a line transfer or a new activation code for the new phone.
How long do I have to activate the eSIM before the QR code expires?
It varies by carrier, and there's no single figure applicable to all cases; what is consistent is that most codes are single-use, so avoid scanning it "to test" if you're not going to complete the activation at that moment.
What's the difference between my carrier's eSIM and a travel eSIM?
Your carrier's (like Metro by T-Mobile) is designed for your daily use in your country of residence. A travel eSIM is a separate data line, designed for use abroad without touching your main plan or relying on roaming.
Conclusion
If activating your Metro by T-Mobile eSIM was the step before an international trip, that's exactly the point where it's useful to separate the two needs: your local line is still yours for when you return, and for days outside the country, a travel eSIM prevents you from relying on your carrier's roaming or buying a physical SIM upon arrival. If that's your case, check out PuraSIM's international eSIM collection, with quick activation and 24/7 support via email and WhatsApp throughout your trip. And if the problem you had was simply technical and has now been resolved with the steps above, the complete guide to eSIM for travel is a good next step before your next itinerary.
