📍 Bolt Help / Dashboard / Troubleshooting / Bolt Checkout Modal Doesn't Open
Bolt Checkout Modal Doesn't Open
How to troubleshoot the Checkout Modal when it does not open for shoppers.

Issue

Selecting the Checkout Button fails to load the Checkout Modal and returns the following error:

An Error Occurred. Reload the page and try again.

Solutions

Here are the top two solutions you can try to resolve this issue. If neither of these solutions work, reach out to the Bolt Support Team.

TIP

Building a custom cart integration? Several other causes produce the same symptom, including an unreachable cart image URL, a division with no payment processor, and a platform value checkout does not recognize. See custom cart troubleshooting.

Step 1: Verify URL Is A Trusted Domain

We require URLs that handle checkout to be registered as Trusted Domains in the Bolt Merchant Dashboard.

  1. Log in to the Bolt Merchant Dashboard.
  2. Navigate to Administration > Trusted Domains.
  3. Select + Add Domain.
  4. Add all relevant permutations of the required domain.
    • www.yourstore.com
    • www.ys.com (any applicable CNAMEs or aliases)
    • www.yourstore.eu
  5. Select Add Domain to save.

Refresh your browser and try to checkout again.

Step 2: Verify Publishable Keys

Publishable Keys are part of your API key set and must be linked to your storefront from the track.js and connect.js scripts.

Step 1: Obtain Publishable Key

  1. Log in to the Bolt Merchant Dashboard.
  2. Navigate to Administration > API.
  3. Scroll to Publishable Key and copy it. The publishable key is a long string of lower and upper case letters and numbers that consists of three sections. publishable key

Step 2: Update Publishable Key

  1. Log in to your Storefront Admin Console.
  2. Navigate to your storefront’s header file.
  3. Verify the publishable key for the track.js script:
<script
  async
  id="bolt-track"
  type="text/javascript"
  src="{CDN_URL}/track.js"
  data-publishable-key="{PUBLISHABLE_KEY}"
></script>
  1. Verify the publishable key for the connect.js script:
<script
  id="bolt-connect"
  type="text/javascript"
  src="{CDN_URL}/connect.js"
  data-publishable-key="{PUBLISHABLE_KEY}"
></script>
  1. Ensure the CDN URL is the following production URL: https://connect.boltapp.com .
  2. Save your file.

Refresh your browser and try to checkout again.

troubleshooting