Enable SSO Commerce

Bolt’s SSO Commerce offering upgrades your existing shopper accounts for seamless login and access to all of Bolt’s account-based shopper features. Bolt Single Sign-on enables merchants to increase account adoption, reduce account friction, and leverage the Bolt Account Network.

How to Set up SSO Commerce

1. Map All Login Workflows

Step through your storefront’s main pages and create a list of all login and registration buttons (and links). We recommend checking both as an end user via your storefront and as an admin via your theme files. You can compile this list as a series series of screenshots, a text document, or a spreadsheet.

After you have completed this list, submit it to your Bolt Customer Success Manager.

If possible, try to include the element names of these buttons so the Bolt team can quickly find them across your theme files.

2. Choose between Managed or Direct API Setup

  • For direct API integrations, follow this walkthrough.
  • For Managed Bolt Plugin integrations, continue to step 3.

3. Upgrade Your Bolt Plugin

While your team is accounting for all login and registration workflows across your storefront, you can begin updating your Bolt plugin to the latest version. This ensures compatibility with all SSO-related features while also giving you the latest and greatest Bolt has to offer.

4. Grant Bolt Access

Bolt’s internal team needs access to your platform’s staging and production environments to complete the following actions:

  • Account conversion
  • Script and Button replacements
  • Theme styling
  • Testing

Access to BigCommerce

  1. Log in to BigCommerce.
  2. Navigate to Apps > Bolt Checkout.
  3. Accept the following permissions request from Bolt: bolt-access-request-bigc
  4. Notify your Customer Success Representative that access has been granted to the Bolt team.

5. Review the Implementation

After Bolt has completed setup, it’s time for you to review the SSO experience and prepare for go-live.

At this stage, it’s not a bad idea to give your shoppers a head’s up about their account experience update via email or a storefront banner announcement. Once Bolt SSO is live, shoppers are prompted to link their original store account to a new Bolt account.

SSO Commerce Testing

Devices associated with merchant dashboard logins are prevented, by default, from logging into or creating Bolt accounts on your storefront. You can update this setting to DISABLED while testing SSO Commerce. After you are done testing, Bolt recommends re-enabling device management for maximum backoffice order indemnification coverage.


The following text and color settings can be customized to align with your brand:

Customization Variable(s) Default
Bolt Logo Color -bolt-account-sso-logo-color $bolt-blue (#006cff)
Button Text Color -bolt-account-sso-text-color $bolt-blue (#006cff)
Button Text Font -bolt-account-sso-font $system-font-family (-apple-system, system-ui, BlinkMacSystemFont, “Segoe UI”, Roboto, “Helvetica Neue”, Arial, sans-serif;)
Bolt Logo & Text Color -bolt-account-sso-color $bolt-blue (#006cff)

Both the text (--bolt-account-sso-text-color) and logo color (--bolt-account-sso-logo-color) take precedence over --bolt-account-sso-color.


How did we do?

📖On This Page