BigCommerce Buyer Portal Migration Checklist: 11 Steps, Go-Live and Rollback
Moving from the legacy B2B experience to the Buyer Portal takes 11 steps in BigCommerce's self-service tool.
You remove the legacy theme code, test in a sandbox, sync orders, then enable the Buyer Portal on your live store. Enabling takes effect immediately. Most problems come from leftover theme code, custom checkout and integrations, so test those hardest.
| 1. Test in the sandbox | Done |
| 2. Remove legacy theme elements | Done |
| 3. Disable Wish Lists | Done |
| 4. Verify entrance points | Done |
| 5. Verify product page buttons | Done |
| 6. Test checkout as a Company buyer | In progress |
| 7. Configure settings | To do |
| 8–11. Test, sync, enable, complete | To do |
Illustrative example
Five things to settle first
This checklist follows BigCommerce's official migration guide and adds what we check at each step.
- Apply for the Buyer Portal through the B2B Edition application form. BigCommerce enables it in your sandbox and adds the self-service tool to your live store, which can take up to a week.
- Use an Owner or Admin account. Only these predefined roles can see the self-service tool.
- Request the B2C order history sync by emailing BigCommerce with your store URL, if B2C customers need to see past orders. B2B orders sync automatically.
- List every legacy customization and sort it with the Buyer Portal Customization Triage.
- Decide on Independent Companies. It can't be reverted once enabled.
The 11 steps, and where each one goes wrong
Test in the sandbox
BigCommerce recommends this but doesn't require it.
- Goes wrong: a sandbox without your integrations or realistic Company data passes tests that production fails.
- Check: connect the integrations you can and load Companies that match your real account structures.
Remove the legacy B2B theme elements
Switch to an uncustomized Stencil theme, or strip the B2B Edition customizations from your current theme.
- Goes wrong: leftover
b3themeConfigcode or B2B scripts conflict with the Buyer Portal. - Check: search the theme's JavaScript and templates for legacy B2B code. See theme compatibility.
Disable storefront Wish Lists
Uncheck "Enable Wishlist" in Settings › General › Display.
- Goes wrong: buyers who relied on Wish Lists can't find their saved products.
- Check: tell those buyers about Shopping Lists before go-live.
Verify entrance points
Sign In, Register / Create Account, Forgot Password and Account links.
- Goes wrong: custom header or footer links still point to legacy account pages.
- Check: click every account link in the header, footer, mobile menu and emails.
Verify product page buttons
Add to Quote and Add to Shopping List.
- Goes wrong: a customized product page doesn't match the button location selectors and class names in the control panel.
- Check: update the selectors, then test simple products, variants and products with options.
Test checkout as a Company buyer
Use the Optimized One-Page B2B Checkout, or update any custom checkout script to the latest B2B Edition checkout source.
- Goes wrong: a custom checkout on old source code breaks payment methods, POs or address rules.
- Check: run checkout for each buyer role and payment method. See integrations to retest.
Configure Buyer Portal settings
Globally under Settings, or per storefront under the Storefronts tab.
- Goes wrong: defaults differ from how your legacy store behaved, such as registration rules or visibility for pending Companies.
- Check: review registration, approval, quotes, invoices and Shopping List settings per storefront.
Test B2B workflows
Quotes, Shopping Lists and invoice payments.
- Goes wrong: a workflow passes for an admin buyer and fails for a buyer with fewer permissions.
- Check: test every buyer role you use, plus a sales rep acting for a buyer.
Sync orders and enable the Buyer Portal
Schedule the order sync, then click "Enable the Buyer Portal" on the dashboard.
- Goes wrong: the sync can take minutes or several hours, and enabling takes effect immediately.
- Check: schedule the sync for migration day and enable in your lowest-traffic window.
Apply your theme and retest
Apply the uncustomized theme, then rerun the Buyer Portal and checkout tests on production.
- Check: repeat steps 4–8 on the live store with real buyer accounts.
Click "Migration complete"
This removes the self-service tool.
- Goes wrong: clicking it early removes your one-click rollback.
- Check: wait until the live store is stable and buyers have ordered without issues.
Go-live day plan
- Order sync scheduled for migration day
- Low-traffic window agreed; key buyers and sales reps told
- Legacy theme kept, unpublished, for rollback
- Test accounts ready for each buyer role
- Checkout, quotes, Shopping Lists and invoices retested on production
- ERP and supply-chain order flow checked with a real test order
How to roll back
In the self-service tool, click "Disable the Buyer Portal", then reapply your legacy theme. You can enable the Buyer Portal again at any time. If you've already dismissed the tool, open a BigCommerce support case to get it back (BigCommerce).
Independent Companies can't be rolled back. Treat that setting as permanent.
Buyer Portal Migration Checklist Questions
How do I migrate to the BigCommerce Buyer Portal?
Apply for the Buyer Portal, then follow 11 steps in BigCommerce's self-service tool: remove legacy theme code, test in a sandbox, configure settings, sync orders, enable the Buyer Portal on your live store, then retest.
What breaks when I enable the Buyer Portal?
The usual problems are leftover legacy theme code, account links pointing to old pages, product page buttons whose selectors no longer match, and custom checkout scripts built on old source code.
Can I roll back the Buyer Portal?
Yes. Click "Disable the Buyer Portal" in the self-service tool and reapply your legacy theme. If you've dismissed the tool, you need a BigCommerce support case. Independent Companies can't be reverted.
Will customers keep their order history?
B2B orders sync automatically. Historical B2C orders sync only if you request it by email, and new B2C orders sync automatically after the Buyer Portal is enabled.
Who can run the migration tool?
Only users with the predefined Owner or Admin role can view and use BigCommerce's self-service migration tool.
Get the checklist, or hand the migration to us
Download the printable checklist, or book a free readiness assessment and we'll run all 11 steps.