How to activate a T-Mobile eSIM?
It is activated from the phone's Settings using the QR code that T-Mobile sends by email or SMS, or manually with an activation code if you don't have a camera available. The complete process, with a stable Wi-Fi connection and a compatible phone, usually takes a few minutes, although the exact time varies depending on the phone model.
The quickest way to resolve the issue is: first, confirm that the phone is compatible and unlocked, then try the QR code, and only if that fails, proceed to manual activation or contact support. The following sections follow this exact order, from the most probable cause to the least probable.
An eSIM is not a physical card that you remove and reinsert: it is a digital profile downloaded to the phone. If the download didn't complete correctly, there is no "reinserting" that will work — you have to delete the profile and install it again from scratch.
What you need before you start
Before touching Settings, gather these three things: the phone you will use (factory unlocked or carrier-unlocked, and eSIM compatible), a stable Wi-Fi network, and the QR code or manual activation code that T-Mobile provided when you signed up for the line. Without an internet connection at that moment, the profile will not download, even if the QR code is valid.
Another detail often overlooked: if you are activating the eSIM on a different phone than the one you used to sign up for the line, that phone must also be unlocked and compatible, not just "have space for another eSIM." It's a good idea to check this in the section on eSIM compatible phones before wasting time with a QR code that will never complete the installation. If you are still unclear about what an eSIM is and how it differs from a physical SIM, it's worth reviewing that first.
Activate via QR code
This is the most common method and the one with the least margin for error if followed in order. It works the same on iPhone and Android, with slightly different menu names:
- Connect your phone to Wi-Fi (do not use mobile data from another line for this).
- Open Settings → Cellular / Mobile Network → Add eSIM (on iPhone: Settings → Cellular → Add eSIM; on Android: Settings → Network & internet → SIMs → Download a SIM).
- Scan the QR code that T-Mobile sent you with your phone's camera, from another device's screen or from the printed paper.
- Confirm the installation and wait for the profile to finish downloading: do not close the app or lock the screen while the progress bar is moving.
- Assign a name to the line (for example, "T-Mobile") and choose if it will be your primary line for calls, messages, and data.
An eSIM QR code can only be scanned once. If you closed it halfway through the process or changed phones after trying, do not scan the same QR again expecting it to work: in most cases, you need to request a new one before proceeding.
| Situation | What to do | How fast it is |
|---|---|---|
| You have the QR code and camera available | QR activation (steps above) | The fastest method |
| You don't have a camera or the QR code is on the same phone you're activating | Manual activation with SM-DP+ code | A bit slower, due to manually entering data |
| You changed phones after activating once | Request a new QR code (the previous one has been used) | Depends on the provider's response time |
| The phone does not appear as compatible | Check compatibility before insisting with the QR code | Fast: just dial *#06# |
Activate without QR code (manual)
If you are activating the eSIM on the same phone where you received the QR code — and therefore cannot scan it with the camera — almost all systems offer a "manually enter details" option. This link is usually hidden in small print at the bottom of the scan screen, not as a main button, so it's easy to overlook and assume it doesn't exist.
For manual activation, you need three pieces of information that come with the QR code (usually in the same email or SMS): the SM-DP+ server address, the activation code, and, in some cases, a confirmation code. These should be entered exactly as they appear, without extra spaces at the beginning or end, because an extra space is the most common reason for manual installation to fail on the first attempt.
- Settings → Cellular / Network & internet → Add eSIM → Use activation details manually.
- Enter the server address and activation code exactly as they appear.
- Confirm and wait for the profile to download, just like with QR activation.
How to tell if your phone is compatible
Not all phones accept eSIMs, and among those that do, not all accept them unlocked from any carrier. Before attempting to activate anything, confirm two separate things: that the model supports eSIM and that the specific unit you have is unlocked to use eSIM profiles from other carriers.
The most reliable way to check in seconds, without guessing by the model year, is to dial *#06# from the call keypad: if the phone is compatible, among the codes that appear you will see one called EID (Eid), which identifies the phone's eSIM chip. If no EID appears, that phone does not have an integrated physical eSIM, no matter how recent the model is.
The guide on eSIM compatible phones details brands and generations with more precision than a general reference year.
QR code won't scan or shows an error
When the QR code doesn't scan, in most cases the problem isn't the phone, it's the code itself or the connection. Before assuming the eSIM is damaged, check in this order:
- Blurry screen or print: increase brightness if the QR code is on another screen, or move back a few inches so the camera can focus properly.
- "This code has already been used": it means exactly that — an eSIM QR code can only be installed once. If you've already tried it before (even if it didn't finish), you need a new code.
- No stable Wi-Fi connection: the scan may complete, but the profile download will be incomplete without an active internet connection.
- Incorrect phone date and time: a date/time discrepancy causes the server to reject the connection without showing a clear reason. Activate them automatically before reattempting.
This is different from an already installed eSIM that stops working overnight; that case is explained in the common eSIM problems guide.
Activated and it says "no service"
If the profile installed but the screen says "no service," the problem is almost always with the network settings, not the eSIM itself. Before deleting the profile and starting over, try this in order:
- Activate airplane mode for a few seconds and then deactivate it: this forces the phone to reconnect to the network from scratch.
- Check that the eSIM line is selected as active for mobile data in Settings, and not the other line if you have dual SIM.
- Restart the phone (not just airplane mode) if the previous step didn't change anything.
- Confirm that the T-Mobile line is activated on the account side, not just installed on the phone: a profile can install correctly even if the line is not yet enabled for service.
If after these steps you still have no service, the next step is no longer technical for the phone but for the account or coverage, and there it is advisable to contact the operator's support directly.
Activating eSIM for use outside the US
This is where many travelers encounter the true limit of a local operator's eSIM: activating it is only the first step, and it doesn't guarantee that it will work the same, or at the same cost, outside the country where it was purchased. International roaming depends on agreements between operators that vary by country and plan, and confirming them requires checking the specific account, not a general guide.
If the eSIM is for travel and the goal is simply to have data as soon as you land, without relying on what roaming agreement your operator has with the destination country, an international eSIM designed for travelers solves that point differently: it activates in the destination, with the country or region's own data plans, without needing to manage roaming with your original operator. The difference between both approaches is explained in more detail in the comparison between travel eSIM and traditional roaming.
PuraSIM, for example, offers data eSIMs for more than 200 destinations, with activation in approximately 1 minute when it's time to use it, and 180 days from purchase to activate it when the trip requires it.
T-Mobile eSIM vs. Travel eSIM: which is better
They are not the same tool, although both use eSIM technology. One is designed to have a line with its own number, calls, and messages; the other, to have mobile data working as soon as you arrive at a destination, without the need for a new permanent line.
| Aspect | T-Mobile eSIM (carrier line) | International travel eSIM |
|---|---|---|
| What it's for | Full line: calls, messages, and data | Mobile data only, designed for short stays |
| Phone number | Yes, own number | Generally no number included, data only |
| Activation | Requires contract or plan with the operator | Purchased and activated when the trip begins |
| Use outside the country of origin | Depends on the roaming agreement of each plan | Specifically designed for use in the destination |
| Support if something goes wrong on the trip | Support from the original operator | In PuraSIM's case, 24/7 email and WhatsApp in all languages |
If you already have a T-Mobile line activated and working, and your plan includes confirmed roaming in the country you are going to, there's no need to add anything else. The shift to a travel eSIM makes sense when the problem isn't activating the eSIM, but rather that, once activated, it doesn't provide reliable service outside the United States, or when you want to separate your main line from the data you use while traveling. Before deciding, it's also worth reviewing the general differences between eSIM and physical SIM if you're still unsure between the two.
Frequently asked questions
Do I need Wi-Fi to activate my T-Mobile eSIM?
Yes, you need an active internet connection—Wi-Fi is the most stable—throughout the profile download process. Without a connection, the QR scan may start but the installation will remain incomplete.
Can I activate the eSIM without having had a physical SIM card before?
Yes. The eSIM does not depend on having used a physical SIM before; it is an independent digital profile that is installed directly with the QR code or the manual activation code provided by the operator.
What happens if I change phones after activating the eSIM?
The eSIM profile does not transfer automatically when moving the line from one phone to another: usually, a new activation code must be requested to install it on the new phone, because the original QR code has already been used once.
Does the activation QR code expire?
It may become invalid after being used once or after a certain period without activation, depending on the operator's policy. If it gives an "invalid code" error without having been used before, the quickest solution is to request a new one instead of continuing to retry.
Can I have both the T-Mobile eSIM and another travel eSIM at the same time?
On phones that support dual eSIM, yes: you can install both profiles and choose from Settings which one uses mobile data at any given time, without needing to delete either.
Why doesn't my eSIM appear in Settings after installation?
Almost always because the installation did not complete, even if the progress bar moved. Repeat the process from Settings → Cellular → Add eSIM and confirm that the profile is visible as an active line before closing the screen.
Can I activate a T-Mobile eSIM while outside the US?
The profile installation can usually be done with any Wi-Fi connection, wherever the phone is. Whether the line provides service with data outside the US depends on the roaming agreement contracted with the operator, not the activation process itself.
Conclusion
Activating a T-Mobile eSIM is, in most cases, a matter of a stable connection, a valid QR code, and a truly compatible phone: check these three points in order before suspecting anything else. If the QR code won't scan, it's almost always a code that has already been used or a misconfigured date/time; if it activates but shows no service, an airplane mode cycle resolves most cases.
Where a local operator's eSIM reaches its limit is in international roaming: that's where it's worth considering an international eSIM for travelers, with over 200 destinations available, activation in approximately 1 minute when the trip starts, 180 days from purchase to activate, and 24/7 support in all languages via email and WhatsApp if something doesn't go as expected along the way. If you are also considering purchasing a T-Mobile eSIM specifically for travel, it's advisable to first review the guide on purchasing a T-Mobile eSIM to compare both options with complete information.
