StrikeTru at AAPEX & SEMA 2026 • Nov 3–6 • Las Vegas • Meet Vik Gundoju, Principal Consultant & Founder • Schedule a Meeting

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.

Native Buyer Portal support · 21 themes
22 Savile RowArtifyArtisanBeautifyCamdenChiaraCornerstoneCovent GardenElevateFortuneHalo OneHeraLifestyleNextGenNobleParts WarehousePinnacleRootsSupermarketSurfs UpVault

From BigCommerce's migration guide, Oct 31, 2026

Native support

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

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.

SettingWhat it controlled in the legacy experience
useContainersWhere B2B elements mount on the page
useStylesStyling of B2B elements
useTextWording of B2B elements
useJavaScriptOverrides and lifecycle hooks for B2B modules
Cleanup

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.

  • B2BthemeConfig settings, usually in assets/js/global.js or assets/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
Decide

Strip, upgrade or rebuild?

OptionChoose it whenTrade-off
Strip the B2B code from your current themeThe theme is reasonably current and most customizations aren't B2B-relatedFastest, but you keep any older theme code
Upgrade to the current version of a natively supported theme, then reapply theme customizationsYour theme is an old version, such as an early Cornerstone release, or heavily patchedMore work up front; you get current fixes and native Buyer Portal support
Build a new themeYou were planning a redesign anyway, or the current theme can't support your rulesHighest cost and longest timeline

Check your version in Storefront › Themes. For Cornerstone, compare it with the latest Cornerstone release on GitHub.

Test

After the theme change, test these

01

Entrance points

Sign In, Register / Create Account, Forgot Password and Account links.

02

Product page buttons

Add to Quote and Add to Shopping List, including the button location selectors and class names in the control panel.

03

Checkout as a Company buyer

Every buyer role and payment method you use.

04

Rebuilt customizations

Every theme customization you carried over. The full test plan is in the migration checklist.

FAQ

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.

Free readiness assessment

Not sure whether to strip, upgrade or rebuild?

We review your theme and customizations and recommend the fastest safe route to the Buyer Portal.