Connect Your BigCommerce Store
Connecting your catalog is a two-field form in your Tenant Dashboard. This is the only configuration that lives in the dashboard; everything else is either BigCommerce merchandising or a store setting.
Your GraphQL origin and Storefront API token from Prerequisites, and your Tenant Dashboard sign-in.
Enter your connection details
- Sign in to your Tenant Dashboard at
https://dashboard-<tenant>.evolvestorefront.com. - Open Storefront in the sidebar.
- Find the BigCommerce Configuration section.
- Fill in both fields:
| Field | Example | Where it comes from |
|---|---|---|
| GraphQL Origin | https://store-abc123.mybigcommerce.com/graphql | Prerequisites, Step 3 |
| Storefront Token | eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9… | Prerequisites, Step 2 |
- Select Save.
Your storefront restarts automatically to pick up the new connection and is serving again shortly afterward.
The same page shows your Storefront URL, the address your shoppers use, along with your subscription tier and expiry. The URL is copyable, so it's the quickest way to open your live site.
Verify the connection
Open your storefront URL and work through this list. If all five pass, your catalog is connected correctly:
- The home page loads without an error page.
- The navigation menu shows your categories. The menu is generated from your BigCommerce category tree.
- A category page lists products, with prices and images.
- A product page opens and shows the right images, price and availability.
- Search returns results for a term you know exists in your catalog.
If all of that works, add an item to the cart and continue to checkout to confirm the handover to BigCommerce works too. See Shopper Accounts & Checkout.
If your products don't appear
| Symptom | Likely cause | Fix |
|---|---|---|
| Every page loads but the menu is empty and no products appear anywhere | Your catalog isn't assigned to the channel your token belongs to | In BigCommerce, assign your categories and products to the Evolve channel |
| Some categories or products are missing, others are fine | Those items aren't visible to the channel, or they're set to hidden | Check channel visibility on the affected items |
| The site loads but data is missing site-wide, and it worked yesterday | The Storefront API token expired or was revoked | Create a new token and save it in the dashboard |
| The site loads but data is missing, and it never worked | The GraphQL origin is wrong, or the token belongs to a different channel | Re-check both values against Prerequisites |
Before you contact support, check that the token was created for the channel you intend to use, and that the GraphQL origin ends in /graphql. Those two account for most of the rest.
If you're still stuck, contact us with your tenant subdomain and roughly when you saved the configuration.
Next Steps
Review Your Store — walk through the storefront page by page before you launch.