eSIM Branding

eSIM branding lets you white-label the experience your end users see when installing and using an eSIM. Each branding profile controls how your eSIMs appear on device — from the carrier name shown in the status bar to the logo on the QR code.

Profiles are created and managed in the portal under Branding. Once a profile is approved, you reference it by ID when placing orders via the API.

What you can configure

Each branding profile contains the following settings. Which options are available to your account depends on your plan:

Setting	Description
QR Code	Custom colour and logo applied to all QR code images
Network Name (SPN)	Your brand name shown as the carrier in the device status bar (max 16 characters)
Install Name	Name displayed on device during eSIM installation (max 16 characters)
SMS Sender ID	The name shown as the sender when you send SMS messages to the eSIM
Android Direct Install	App fingerprint and package name to enable in-app eSIM installation on Android

Approval

New profiles and changes to the SMS Sender ID require review by eSIM Go before taking effect. A profile’s status is shown as:

Status	Meaning
Pending	Submitted and awaiting review
Approved	Active and can be used in orders
Rejected	Not approved — check the review comment and resubmit

SMS Sender ID approval can take up to 2 weeks. Until approved, messages are sent from the default sender ID eSIM.

Note

Changes to an approved profile only apply to newly generated eSIMs. Existing eSIMs are not updated retroactively.

Using a branding profile when ordering

When placing an order via the API, pass the profileID field in the request body to select a specific branding profile:

{
  "type": "transaction",
  "assign": true,
  "profileID": "f616f7g8-ey0d-123d-803d-0214a2f5dafb",
  "order": [...]
}

If profileID is omitted, the default profile is used automatically.

To find a profile’s ID, go to Branding in the portal, open the profile, and copy the ID shown on the profile page.

The order response includes a brandingId field confirming which profile was applied. If the default profile was used, the response shows (default).

Multiple profiles

You can create multiple branding profiles — useful if you operate multiple brands or sub-brands from the same eSIM Go account. The first profile created becomes the default and is used for any orders where profileID is not specified.