Why is my T-Mobile eSIM not working?
A T-Mobile eSIM most often stops working because activation didn’t complete, your device is carrier locked or doesn’t support eSIM technology, a transfer failed, or an account setting is preventing the change. Problems can also occur after a device reset or if the phone wasn’t connected to Wi-Fi during setup. The following are some of the most common reasons why your eSIM might not be working:
Incomplete activation. The eSIM profile may have downloaded without fully activating on T-Mobile’s network.
A carrier-locked or incompatible device. Your phone must support eSIM technology and needs to be unlocked if it came from another carrier.
SIM Protection. T-Mobile’s SIM Protection can prevent some SIM changes or eSIM activations, although Apple-to-Apple eSIM transfers are an exception.
A deleted or duplicated eSIM profile. Resetting a device, deleting a cellular plan, or installing the profile more than once can interfere with setup.
No Wi-Fi during setup. T-Mobile typically requires an internet connection for eSIM activation and transfer.
An account restriction or unpaid balance. If your T-Mobile account is restricted or suspended, you won’t be able to activate your eSIM or use mobile data.
Outdated software. Older versions of iOS or Android can cause compatibility or activation problems.
A missing carrier settings update. Outdated network settings can prevent your phone from connecting properly.
Roaming disabled abroad. When you’re traveling outside the US, remember to turn on data roaming and double-check that your plan includes international data.
Too many stored eSIM profiles. If you see an “eSIM limit reached” message, remove an unused profile before installing another.
T-Mobile error codes can help narrow down the problem: error 511 indicates an eSIM transfer problem, error 512 requires T-Mobile assistance, and error 519 means SIM Protection is blocking activation.
If you need mobile data while troubleshooting your T-Mobile line abroad, a travel eSIM such as Saily can provide a backup connection. Saily is a prepaid eSIM service with data plans in 200+ destinations. You can install and manage it through the Saily eSIM app without scanning a QR or manually entering an activation code.
💡 Good to know: Having trouble with a different carrier? See our guides to fixing an AT&T eSIM not working or a Verizon eSIM not activating.
How to activate a T-Mobile eSIM manually
To manually activate a T-Mobile eSIM, connect to Wi-Fi and follow the eSIM setup prompts in your device settings or activate it through T-Life (the official T-Mobile app). If your phone asks for a QR code, check your email because T-Mobile usually sends one for manual activation. If your eSIM is ready, you may be automatically prompted to complete setup.
How to activate an eSIM on an iPhone:
Go to “Settings” > “Cellular” > “Add eSIM.”
Choose “Use QR code” if T-Mobile provided one or “Transfer from nearby iPhone” if you’re moving an existing line from another compatible iPhone.
Follow the prompts to download and activate the plan.
Label the line if you use more than one SIM.
Under “Cellular data,” make sure the T-Mobile line is selected if you want to use it for mobile data.
How to activate an eSIM on Android devices (menu names vary by device):
Open “Settings” > “Network & Internet” > “SIMs” > “Add SIM.” (Some phones may show “Add eSIM,” “Set up an eSIM,” or “Download new SIM”.)
Follow the prompts to download the T-Mobile eSIM.
If prompted, scan the QR code provided by T-Mobile and complete setup.
After installation, restart your phone if the line doesn’t connect. If you’re abroad, confirm that “Data roaming” is enabled for the T-Mobile line and your plan includes service at your destination. Make sure to also install available software or carrier settings updates.
Why is my T-Mobile eSIM QR code not working?
A T-Mobile eSIM QR code may fail if your phone isn’t connected to the internet, the device isn’t eSIM compatible, or T-Mobile hasn’t associated the correct EID with your line. Connect to stable Wi-Fi and scan the QR code sent for your current activation. If it still doesn’t work, use T-Life or contact T-Mobile for a new eSIM setup.
Why is my eSIM on but not working?
If your T-Mobile eSIM shows as active but isn’t working, the wrong SIM may be selected for cellular data, data roaming may be turned off, or your network or APN settings may be preventing a connection. Try these fixes in order:
Toggle airplane mode on and off. Turn it on for about 30 seconds, then off to force your phone to reconnect.
Check your data line. On a dual-SIM phone, make sure the T-Mobile eSIM is selected for cellular data.
Turn on data roaming abroad. Enable it for the T-Mobile line if you’re using an eligible plan outside the US. See our guide to how international roaming works for more details.
Check network selection. Start with automatic selection. If you’re abroad and the eSIM doesn’t connect, manually try an available T-Mobile roaming partner if needed.
Check APN settings if you have an Android device. Incorrect APN settings can prevent data on some Android or BYOD devices. T-Mobile generally configures them automatically on iPhones.
Reset network settings. As a last step, reset your mobile or network settings. Some reset options may remove saved Wi-Fi networks or other connection settings.
If your T-Mobile eSIM has no signal abroad, check that T-Mobile offers roaming at your destination and that roaming isn’t blocked on your line. If you have service but still can’t get online, try these additional fixes for cellular data not working.
Does T-Mobile not support eSIM technology?
T-Mobile supports eSIM technology on compatible smartphones, tablets, and cellular smartwatches as well as physical SIM cards on compatible devices, so an eSIM failure usually points to a device, account, or activation problem. Your device must support eSIM technology and T-Mobile’s network, and a phone locked to another carrier must be unlocked first.
To check whether your phone supports eSIM technology, dial *#06# and look for an EID, the identifier associated with an embedded SIM. You can also find device information under “Settings” > “General” > “About” on an iPhone or “Settings” > “About phone” on most Android devices. T-Mobile also lets you enter your EID or IMEI into its compatibility checker.
If you’d rather skip the digging, you can simply look up your phone model in Saily’s list of eSIM-supported devices.
Why is my T-Mobile eSIM transfer not working?
A T-Mobile eSIM transfer can fail because the devices aren’t properly connected, SIM Protection is blocking the change, or the transfer didn’t complete. For direct transfers, keep both devices powered on, nearby, and connected to Wi-Fi. Turn on Bluetooth when prompted.
If SIM Protection is enabled, you may need to turn it off before trying again. Apple-to-Apple eSIM transfers are an exception — T-Mobile claims that SIM Protection doesn’t block them.
The transfer method also depends on the devices involved, especially if you use the line across multiple devices. Compatible iPhones that support eSIM technology can transfer an eSIM directly to another iPhone, and some newer Google Pixel models support direct transfers from an iPhone or another supported device. Other device combinations may require activating through T-Life or installing a new eSIM profile.
If you see error code 511, T-Mobile recommends trying manual setup. Error code 519 means SIM Protection is preventing activation. If manual setup fails, contact T-Mobile.
Avoid deleting the working eSIM from your old device until the new device shows T-Mobile service. If the old phone has already been erased or the profile is gone, you may need to activate the line again on the new device.
How to restore a T-Mobile eSIM
To restore a deleted or broken T-Mobile eSIM, use T-Life to activate the line again or contact T-Mobile support, then download the profile over Wi-Fi. A deleted eSIM can’t simply be recovered from the device — it needs to be reactivated and downloaded again.
If the deleted eSIM was your only internet connection, connect to Wi-Fi before opening T-Life. Select the line you want to restore, choose “SIM transfer or activation,” and follow the prompts to enter your device’s IMEI and EID. Once T-Mobile processes the change, complete the eSIM download.
You can also run T-Mobile’s built-in troubleshooter under “Manage” > “Your device” > “Troubleshoot this device” to check account provisioning, network issues, software, and connection settings.
If the same activation error appears after a couple of attempts, stop retrying and contact T-Mobile from another phone or visit a store.
What to do if your T-Mobile eSIM stops working abroad
If your T-Mobile eSIM stops working abroad, a backup travel eSIM can help you stay connected while you troubleshoot your T-Mobile line.
Most recent eSIM-compatible phones can store multiple profiles, and many support two active lines at once. You can use a travel eSIM for data without deleting T-Mobile, while leaving your T-Mobile line available for calls and texts when possible. Below is a quick-glance comparison of the two options — what they’re best for and how international data works with each.
Option | Saily | T-Mobile roaming |
|---|
Best for
| Prepaid mobile data while traveling. | Keeping your existing number and carrier.
|
|---|
Setup
| Install through the Saily app over Wi-Fi. | Keep using your existing T-Mobile line. |
|---|
International data
| Buy a prepaid plan for your destination. | Check your allowance — it depends on your T-Mobile plan or International Pass. |
|---|
Phone number
| Get an optional US-based number add-on. | Keep your existing T-Mobile number. |
|---|
Note that T-Mobile’s international roaming care line is +1-505-998-3793. Calls to customer care from a T-Mobile handset are free of roaming, airtime, and long-distance charges.
💡 Pro tip: T-Mobile roaming rules vary by destination. If Japan is on your itinerary, see “Does T-Mobile work in Japan?” for plan and coverage details. Heading to Europe? Before you leave, check whether T-Mobile works in Europe and what your plan includes.
Tips for planning a trip without eSIM problems
Set up and test your mobile connection before you leave home rather than waiting until you’re at the airport or already abroad.
Check device compatibility and lock status. Dial *#06# and look for an EID to confirm your phone supports eSIM technology. Make sure it isn’t locked to another carrier.
Install and activate over home Wi-Fi. eSIM profiles need an internet connection to download, so completing setup before departure can prevent problems when you land.
Keep your T-Mobile account details handy. Save the information you may need to verify your account when contacting support, rather than relying on an old eSIM QR code to reactivate your line.
Check SIM Protection before switching phones. If SIM Protection is enabled, you may need to turn it off before transferring or activating an eSIM. Apple-to-Apple eSIM transfers are an exception.
Update iOS or Android before you fly. Installing the latest software version helps ensure your phone has the current eSIM, network, and carrier support.
Keep a backup travel eSIM ready. Saily can be installed directly through the app without QR or manual activation codes and offers prepaid data in 200+ destinations. On a dual-SIM phone, set Saily as your mobile data line and turn off “Cellular data switching” so your phone doesn’t switch back to T-Mobile for data. If you run into trouble, Saily’s 24/7 live chat and ticket support are available. And if you keep your T-Mobile line active for calls and texts, check your international roaming benefits and charges before departure.
