Tebex setup
Where to find the two Tebex keys the theme needs.
Cubed needs two values from Tebex. They are different keys, from different pages, and they do different jobs.
1. Your Headless API public token
This is the key that makes your store appear. Without it, no categories, no packages, no basket.
Open the Creator Panel
Go to creator.tebex.io and sign in.
Go to Integrations → API Keys
Find the value labelled Public Token. It is a long string of letters and numbers.
Copy it
This is your TEBEX_TOKEN.
Do not rename this variable to start with NEXT_PUBLIC_. Despite Tebex
calling it a "public" token, the theme keeps it on the server on purpose. Anything
named NEXT_PUBLIC_* gets shipped to every visitor's browser, where it can be
scraped and abused against your store.
Check Headless is enabled
If your store was created a long time ago, Headless API access may be switched
off. In the Creator Panel, under your webstore's settings, make sure the Headless
API is enabled. Without it you will get errors like Tebex API 403 even with a
correct token.
2. Your game server secret key
This one is optional but recommended. It powers two features:
- the sale banner across the top of the store when you run a Tebex sale
- the gift card balance check in the footer
Go to Game Servers
In the Creator Panel, open creator.tebex.io/game-servers.
Edit the relevant server
Click Edit on the server your store sells for.
Copy the secret key
This is your SERVER_SECRET.
If you leave SERVER_SECRET empty, the site still works perfectly. The sale
banner simply never appears, and clicking "check gift card balance" returns an
error to the visitor. Everything else — browsing, basket, checkout — is unaffected.
What each key can do
TEBEX_TOKEN | SERVER_SECRET | |
|---|---|---|
| Found under | Integrations → API Keys | Game Servers → Edit |
| Talks to | headless.tebex.io | plugin.tebex.io |
| Required? | Yes | No, but recommended |
| Used for | Store catalogue, basket, checkout | Sales, gift cards |
| If wrong | Store pages error | Sales/gift cards fail quietly |
Set your store's own currency in Tebex
The theme shows prices in your Tebex store currency by default, and lets visitors switch to other currencies for display. Set the store currency inside Tebex — the theme reads it automatically. See Currency for the display side.
Next
You have both Tebex keys. Now create the Supabase project that holds your settings and uploads: Set up Supabase.