ONYX
Docs

eSIM Lifecycle

Install and activate service on your device.

The eSIM Lifecycle explains what happens after you buy service.

Your eSIM is the digital SIM profile installed on your device. Onyx delivers installation details when your service is ready.

Activation

eSIM activation timeline

Select an activation state to see what your account should show and what action is available.

eSIM state

Ready to install

Action

Available action

Open activation instructions

Next

Recovery note

Stay on Wi-Fi during setup

Important
Onyx connection readiness visual

Activation status remains visible from the account.

Before Installation

You need a compatible eSIM device. Your device may also need to be unlocked and able to use the selected network bands.

Check compatibility before checkout when possible.

Delivery

After checkout, Onyx prepares your service and delivers install details through your account.

Your eSIM delivery can show not ready, ready, installed, or unavailable.

Installation Methods

Depending on your device and service state, installation may use:

  • QR code installation.
  • Direct device handoff.
  • Manual setup instructions.

Follow the instructions shown in your account.

Activation

After installation, your device may need cellular data settings, roaming settings, or time to register on the local network.

Activation can show not ready, ready, installed, active, or failed. The activation screen can also show pending, in progress, failed, healthy, or success states.

Usage

After activation, your account can show usage, remaining data, total data, usage percentage, and whether the usage snapshot is current or delayed.

Usage can also show unavailable or depleted.

Recovery

If activation fails, check device compatibility, region coverage, cellular settings, and whether your eSIM is ready to install.

Do not delete an installed eSIM unless Onyx support or the account flow tells you to do so.