Is Your Theme Buyer Portal Compatible?
The Buyer Portal works with any Stencil theme, but not with a legacy B2B Edition theme.
Before you enable it, switch to an uncustomized Stencil theme, or remove the B2B Edition customizations from your current one. Twenty-one themes, including Cornerstone, support the Buyer Portal's sign-in links and product page buttons natively. Customized or third-party themes may need development work.
From BigCommerce's migration guide, Oct 31, 2026
Themes with native Buyer Portal support
BigCommerce lists 21 themes that support the Buyer Portal's entrance points and buttons out of the box, shown above. Some are marked as recommended if you plan to use the Junior Buyer role.
If your theme isn't on the list and is uncustomized, ask BigCommerce to support it by emailing buyerportalmigration@bigcommerce.com.
Why legacy B2B themes don't work
The legacy B2B experience lives inside the theme. Developers customize it through B2BthemeConfig settings in the theme's JavaScript (BigCommerce). The Buyer Portal is a separate React app that doesn't use Stencil's theme objects, so that code has nothing to attach to and can conflict with it.
| Setting | What it controlled in the legacy experience |
|---|---|
useContainers | Where B2B elements mount on the page |
useStyles | Styling of B2B elements |
useText | Wording of B2B elements |
useJavaScript | Overrides and lifecycle hooks for B2B modules |
What to remove from a legacy B2B theme
Before deleting anything, sort it with the Buyer Portal Customization Triage. Business rules such as supplier minimums still need a home in the new theme.
B2BthemeConfigsettings, usually inassets/js/global.jsorassets/js/theme/global.js- Custom mount points and containers added for B2B elements
- JavaScript overrides of B2B modules (
overwrite,beforeMount,mounted,callback) - Header, footer and menu links that point to legacy B2B account pages
- Custom templates or scripts that rebuilt account, quote or invoice pages
Strip, upgrade or rebuild?
| Option | Choose it when | Trade-off |
|---|---|---|
| Strip the B2B code from your current theme | The theme is reasonably current and most customizations aren't B2B-related | Fastest, but you keep any older theme code |
| Upgrade to the current version of a natively supported theme, then reapply theme customizations | Your theme is an old version, such as an early Cornerstone release, or heavily patched | More work up front; you get current fixes and native Buyer Portal support |
| Build a new theme | You were planning a redesign anyway, or the current theme can't support your rules | Highest cost and longest timeline |
Check your version in Storefront › Themes. For Cornerstone, compare it with the latest Cornerstone release on GitHub.
After the theme change, test these
Entrance points
Sign In, Register / Create Account, Forgot Password and Account links.
Product page buttons
Add to Quote and Add to Shopping List, including the button location selectors and class names in the control panel.
Checkout as a Company buyer
Every buyer role and payment method you use.
Rebuilt customizations
Every theme customization you carried over. The full test plan is in the migration checklist.
Theme Compatibility Questions
Is my theme compatible with the BigCommerce Buyer Portal?
Any Stencil theme can run the Buyer Portal, but a legacy B2B Edition theme can't. Twenty-one themes, including Cornerstone, Camden and Supermarket, support its sign-in links and buttons natively. Customized themes may need development.
Can I keep my customized theme?
Often, yes. Remove the legacy B2B Edition code, keep the customizations that still matter, and test the Buyer Portal's entrance points and buttons. Heavily patched or old themes are often better upgraded.
Do I need to upgrade an old Cornerstone theme?
If it's an early release with heavy customizations, upgrading to the current Cornerstone and reapplying only the customizations you need is usually cleaner than stripping B2B code from the old one.
Does the Buyer Portal work on Catalyst or headless storefronts?
Yes. The Buyer Portal isn't tied to Stencil, though setup differs on Catalyst and headless storefronts. See hosted vs custom Buyer Portal.
Not sure whether to strip, upgrade or rebuild?
We review your theme and customizations and recommend the fastest safe route to the Buyer Portal.