Install and share an eSIM
Use this guide after your order completes. You need permission to read installation credentials, an unlocked compatible device, and a working internet connection on that device. Check the package's activation rule before installing so you know when its validity starts.
1. Open the installation page
Open the profile from eSIMs and select Install. Choose iPhone or Android to show the matching instructions. Keep this page private: its QR code and activation details can install the eSIM.
A test-mode eSIM contains sample credentials for integration testing. Those credentials cannot install a profile or activate service on a phone.
2. Send setup to another person
If someone else will use the eSIM, return to its detail page and select Send install link under Install link deliveries. Choose Email or SMS, enter the intended recipient, and select Send link. Assignment to a person does not send installation details automatically. The recipient opens the link and selects Show installation details without signing into a workspace.
Check Install link deliveries for the recipient, delivery status, and Link expiry. A queued message has not yet confirmed delivery, and delivery does not confirm installation. If sending is disabled, check Send install credentials to travelers in eSIM Settings and your credential permissions.
Anyone with the hosted link can access installation details until it expires or is revoked. If you sent it to the wrong person, use Revoke for that recipient in the eSIM's Danger zone. Revocation stops future access through the link; credentials already revealed and profiles already installed remain usable.
For your own delivery workflow, create a hosted installation link through the API and share it privately. Use the returned expiry when deciding whether an existing link is still suitable to send.
3. Install the profile
Connect the intended phone to Wi-Fi or a hotspot, then choose a method from the installation page:
| Method | What to do |
|---|---|
| Scan a QR code | Display the installation page on another screen. On iPhone, scan with Camera and open the cellular-plan notification. On Android, open SIM settings, choose to add an eSIM, and scan the code. |
| Install on this phone | Open the page on the phone that will use the eSIM. Expand Install on this phone and select the button to open iPhone or Android setup. If setup does not open, use QR or manual entry. |
| Enter details manually | Expand Enter details manually. On iPhone, enter the SM-DP+ address and the activation code labeled as the matching ID. On Android, enter the full activation code. Follow the manual setup steps shown on the page. |
Follow the device prompts to finish adding the profile. Enter a confirmation code if the page provides one; otherwise leave that field empty. Android menu names vary by device.
4. Connect to mobile data
Give the installed line a recognizable label and select it for mobile data. If the installation page instructs you to enable data roaming, enable it for this eSIM. If an APN is provided and manual configuration is needed, copy that value into the eSIM's network settings.
In a covered destination, turn off Wi-Fi briefly and open a webpage to test mobile data. A completed purchase or an installed profile does not confirm a working mobile connection. For a dual-SIM device, check that the data test uses the intended line.
Return to the eSIM detail page to review Device installation and Data packages. Installation reports and balance updates can lag the device result; retain the eSIM and order IDs if you need support.
Troubleshooting
| Problem | Next step |
|---|---|
| The install link did not arrive | Check the recipient and delivery status before resending. |
| The hosted link expired or was revoked | Send a new link for the existing eSIM after confirming the recipient. |
| The phone rejects the profile | Check device compatibility and carrier lock status. Record the exact error and contact support before deleting the profile or trying another device. |
| The profile installed but has no data | Check the selected data line, covered country, package validity, and the supplied roaming and APN instructions. Follow the service recovery guide. |
If installation details are temporarily unavailable, reopen the existing eSIM. That failure does not establish that the purchase failed. Keep QR codes, activation codes, and private installation links out of public messages, analytics, and routine support notes.
Next steps
Related resources
Continue with the documentation, guides and examples for this topic.