For the complete documentation index, see llms.txt. This page is also available as Markdown.

Migrating from Another Platform

Import your products and categories from Tebex, and understand exactly what does and does not come across.

The data migration tool imports your catalogue from another platform so you don't rebuild it by hand.

The Data Migrations page is not in the main sidebar. Reach it from your account menu → Migrate Data (shown only if you have product_create and tag_create), or from the Moving from a competitor? card on the Onboarding page.

What gets migrated

The gaps catch people out, so read this before you start.

Migrated?

Products

✅ Yes, except their commands

Categories

✅ Yes

Templates

⚠️ Supported, but separately. Create them under the Webstore tab

Commands

❌ No

Customers

❌ No

Active subscriptions

❌ No

Order history

❌ No

Existing subscribers do not carry over

Recurring billing agreements live with the old platform's payment processor and can't be transferred. A subscription bought on Tebex stays on Tebex.

Those subscriptions carry on billing on the old platform until they lapse, and they pay out there too. Nothing about the migration cancels them or moves them. An old subscriber lands on PayNow when they next buy something.

What you do with the old store after that is up to you.

Running a migration

1. Collect your Tebex tokens

You need two, both from your Tebex account. The form links to both.

Token
What it is

Headless API Token

Your Tebex public token

Plugin Token

Your Tebex plugin token

The Plugin Token is a secret. Paste it directly into the migration form. Don't post it in Discord, a support ticket, or anywhere else while asking for help.

2. Start the migration

  1. Open the Data Migrations page (account menu → Migrate Data).

  2. Click New data migration.

  3. Set Import data from to Tebex.

  4. Paste your Headless API Token.

  5. Paste your Plugin Token.

  6. Click Start.

The Create a data migration dialog with Tebex selected as the source, showing which data will be migrated.
The dialog states exactly what will be imported before you start.

3. Re-add commands

Work through every imported product and attach its commands. See Creating a Product and Global Commands.

4. Migrate your templates

Templates go through the Webstore tab rather than the migration tool. PayNow templates have a Tebex compatibility mode, so an existing Tebex template can be uploaded and run with minimal rework.

5. Test before announcing

Run through the Going Live Checklist and buy at least one product yourself to confirm delivery works.

Suggested order

  1. Run the data migration. Products and categories arrive.

  2. Re-add commands to every product.

  3. Upload or rebuild your template.

  4. Link your game server.

  5. Test purchases for each product type.

  6. Set up payouts and complete verification.

  7. Go live.

Last updated