Installation says it failed. What now?

Do not retry repeatedly. Check three things first: your internet connection, free profile slots on the device, and whether this profile was already installed. Then contact us with the exact on-screen message.

1. Confirm the device is on Wi-Fi and the internet works
2. Open the plan list in cellular settings: is it already there, or are the slots full?
3. Restart the device and try once more
4. If it still fails, send us the order number, device model and the message shown

A message saying the installation failed tends to appear at the least convenient moment: the night before a flight, or worse, while you are standing at the baggage belt at the other end. The first instinct is almost always to scan again, then again, then once more. Repeated retries are the one thing that genuinely makes the situation more complicated. So this page starts with what not to do, then works through the causes in the order they actually occur.

The good news belongs in the first paragraph: a failure message usually does not mean the profile is damaged or that your money is gone. In most cases the installation simply did not reach the finish line and the system backed out cleanly. The profile is still waiting where it was, ready for a fresh attempt in better conditions. The job is to find what is in the way, not to rush out and buy a second one.

Why hammering the install button is a bad idea

Installing an eSIM profile is not copying a file onto the phone. It is a conversation between your device and the server that holds the profile, with several verification steps along the way, each with its own time limit. When you tap again before the previous round has finished, the phone opens a second negotiation on top of the first. The two collide, and a round that was about to succeed can be cut short along with the one you just started.

There is a side effect people rarely consider: dozens of failed attempts make the aftermath much harder to investigate. When you contact us, the fastest thing you can hand over is one clear message with the time it appeared — not an account of thirty attempts since last night, because that makes it impossible to tell when the real problem occurred.

The three things to check first, every time

The short answer above names three things: the internet connection, the profile slots on the device, and whether this profile has already been installed. These three are not arbitrary. Between them they explain nearly every case that reaches us, and you can check all three yourself without waiting for a reply from anyone.

• Does the connection you are on actually reach the outside world, rather than merely showing a Wi-Fi icon? Open any web page to prove it.
• Does the phone still have room for another profile? Different models hold different numbers, and expired profiles still occupy their slot.
• Has this profile already been installed, on this phone or another one? A QR code is normally good for one installation only.
• Is the phone in your hand genuinely eSIM-capable, and free of a carrier lock?
• Is the operating system reasonably up to date? Devices left on a very old version run into installation trouble more often.
• Do you have a few unhurried minutes? Installing while walking to a boarding gate is a recipe for mistakes.

Point one: a connection good enough to install over

Installation downloads the profile from a server, so the phone must genuinely reach the internet at that moment. The most common trap is hotel, airport or café Wi-Fi that requires you to accept terms on a web page first. The icon shows full bars, but everything except the login page is blocked, and the installation fails without telling you why.

A weak signal is just as damaging. A connection that keeps dropping interrupts the download and the system reports a failure. If the Wi-Fi where you are standing is unstable, it is better to use data from a working main SIM, or to borrow a hotspot from a travel companion for the couple of minutes it takes.

Another group of failures comes from tools you switched on yourself. A VPN, an ad-blocking filter or a custom DNS profile all reroute traffic. Turn them off for the duration of the installation and switch them back on once the profile is in place.

Point two: the profile slots on your device

An eSIM-capable phone stores a limited number of profiles, and that number varies by model and by operating system version. What people overlook is that used-up or expired profiles do not disappear on their own. They sit in the device and keep occupying a slot. Frequent travellers who never clear old profiles tend to hit this wall around their fourth or fifth trip.

A full device rarely says so plainly. It surfaces as a generic message about being unable to add a cellular plan or complete the request. To check, open the list of lines in your phone's network settings and count the profiles. If any of them belong to a trip that ended long ago, those are the ones to remove.

Point three: has this profile already been installed?

An eSIM QR code is normally single-use. Once the profile has been pulled down onto a device, scanning the same code again will not work — and that is correct behaviour, not a fault. The trouble is that the on-screen message rarely explains this, so people conclude the code is broken.

The usual versions: you scanned it at home and forgot, a family member scanned it onto their own phone by mistake, or it went onto an older handset before you switched devices. All three end the same way — the profile lives somewhere else now. The simplest check is to open the list of lines on every phone involved and look for one that resembles the plan you just bought.

Reading the on-screen message properly

Failure messages differ by manufacturer and by OS version, so the table below does not quote exact wording. It groups messages by what they are telling you, because the meaning is what points at the fix. Match what you see against the first column and start with the remedy on that row.

A safe order to work through

The sequence below runs from the least risky action to the most. Do one thing at a time and stop the moment the installation succeeds. Do not stack changes: if it works you will not know which one fixed it, and if it does not you will not be able to tell us what you have already tried.

1. 1Screenshot the message firstBefore dismissing the message, take one screenshot. It is the single piece of evidence that shows which step the phone stalled at, and it lets us answer far faster when you get in touch.
2. 2Change the connectionIf you were on public Wi-Fi, move to data from a working main SIM, or to a different Wi-Fi network. Load a web page to confirm the connection really works before trying again.
3. 3Turn off VPNs and filtersSwitch off any VPN, ad blocker and custom DNS profile so the connection is as plain as possible while the profile downloads.
4. 4Restart the phone onceA restart clears the stuck state left over from the previous attempt. It sounds trivial, but it resolves half-finished installations more often than people expect.
5. 5Count the profiles on the deviceOpen the list of lines in the network menu, count them, and look for any that belong to a finished trip. Only if you are certain you will not need one again should you delete it to free a slot.
6. 6Try the installation once moreOnce you have changed the thing you suspect, try again a single time. If it still fails, do not go for a third round — move to the next step instead.
7. 7Try manual entryIf the camera cannot read the code because the image is blurred or reflective, use manual entry instead. Most phones offer that option on the same screen as the scanner.
8. 8Contact us with the screenshotSend us the screenshot, the order number, the phone model and the time it happened. The more complete that is, the faster we can look into it.

Menus differ from phone to phone

We deliberately avoid quoting exact menu paths here, because names and screen order vary by manufacturer and OS version. Look for wording in the family of mobile network, SIM or connections, and inside that screen for an option to add a line or add a cellular plan. If you cannot find it, use the search box in settings and type eSIM.

If the installation hangs part-way

Sometimes the screen does not report a failure but sits on a spinner for an unusually long time. Give it two or three minutes first, because some profiles genuinely take a while to download. If nothing has moved after that, close the screen, restart the phone, and check the list of lines before doing anything else — occasionally the profile arrived and only the screen failed to update.

Install before you fly, or wait until you land

This question bears directly on failure messages, because where and when you install changes how likely you are to hit trouble. The trade-offs are below, and they should be read alongside the terms of the plan you bought, since different plans start counting at different moments.

What to send when you contact us

If you have worked through the steps above and it still fails, sending complete information in your first message saves a great deal of back and forth. The table below lists what we routinely ask for and why we ask for it.

The fastest channel is LINE at https://lin.ee/skDPoNx (@esimonline), because you can attach the screenshot in the same chat. If email suits you better, write to esimonline.asia@gmail.com and attach the image there, or call 089-942-0818 or 088-521-6848. We take messages 24 hours a day, though the small hours in Thailand can be slower than usual.

Read the full step-by-step install guide

Avoiding a repeat on the next trip

Anyone who has seen a failure message once would rather not see it again. Only a handful of habits actually help, and all of them are about timing and tidiness rather than technical skill.

1. Check the phone model before buying, especially if you have just changed handsets or bought second-hand.
2. Install at home on a connection you trust, at a time when you are not rushing, and after reading how the plan starts counting.
3. Keep the order confirmation email rather than deleting it — it is your route back to the QR code and your details.
4. Clear out profiles from finished trips periodically, so the device is not full on the day you are in the biggest hurry.
5. Screenshot any unusual message, even if you end up solving it yourself.

Check whether your phone supports eSIM