Create a headless storefront and get a Storefront API token
Build a custom frontend against your store's products, cart, and checkout using the Storefront API instead of a theme.
On this page
You need the store owner account or a staff account with the "Manage and install apps" permission. Headless storefronts aren't available for marketplace stores yet.
Open Headless storefronts
Go to Settings → Apps and sales channels → Headless storefronts.
Create a storefront
Click Create storefront, enter a Storefront name such as "Mobile app", and click Create storefront. A public token is created for it automatically.
Create and copy a private token
For server-side code, click Create private token on the storefront's card. The token is shown once, in the "Copy your private Storefront API token now" card. Copy it into your server-side configuration and never ship it to a browser.
Note the endpoint
Each storefront card shows its Endpoint, the base URL your frontend calls (it ends in /api/storefront/<version>/products), with a Copy button.
Use the public token in browsers
If your frontend calls the API from a browser, use the card's Public token. Under Allowed origins, click Add origin and enter each https:// origin your frontend runs on (up to 20), then Save. Leave the list empty to allow any origin, which is not recommended once you go live.
Mind your plan's storefront limit
The chip next to the page title shows how many storefronts you've used out of your plan's allowance. When you reach it, Create storefront is disabled until you archive one or upgrade (for example, Plus allows up to 25).
Archive when done
Click Archive storefront to retire one you no longer need; every token for it stops working immediately. If your plan changes and you have more storefronts than it allows, the newest ones show "Paused: over plan limit" and their tokens stop working until you archive others or upgrade.
CHECK YOUR WORK
You’re ready when…
IF SOMETHING DOESN’T LOOK RIGHT
Troubleshooting
I lost the private token.
It can't be shown again. Click Create private token to issue a new one, then click Revoke on the old one in the token list.
My browser requests are being rejected.
Add your frontend's exact https:// origin to Allowed origins and save, or leave the list empty while testing (not recommended once you go live). Browsers should use the public token, not a private one.
Is the Storefront API GraphQL?
No. It is a token-authenticated JSON (REST-style) API under /api/storefront/<version>/. Use the Read the docs link on the page for the endpoints.