How to add Amabrik to BigCommerce

Add the Amabrik snippet to your BigCommerce store with Script Manager in the head on all pages, or edit your theme files. A clear step by step guide.

Amabrik runs on your BigCommerce store from one small snippet. You add it once, and from then on every widget you turn on in your dashboard (banner, cookie consent, popup, forms, chatbot, reviews, and the rest) shows up on your store. You don’t add a new snippet per widget, and you don’t touch your store code again when you add or change one.

The snippet looks like this, but use the exact one from your dashboard because it carries your own site ID:

<script async src="https://cdn.amabrik.com/v1/loader.js" data-site="YOUR_SITE_ID"></script>

BigCommerce gives you two ways to add it. Use Method A (Script Manager). It’s the cleanest approach: no code editing, it survives theme changes, and you can remove it in two clicks. Method B (theme files) is there if you’d rather paste it straight into your theme.

1. Get your snippet

  1. Sign in to your Amabrik dashboard.
  2. Open the Install page.
  3. Copy the snippet shown there. It already has your real site ID in data-site, so you don’t need to fill anything in. Keep this tab open, you’ll paste it in a moment.

Script Manager lets you add the snippet without editing any code. It’s the way BigCommerce recommends for adding scripts like this.

  1. In your BigCommerce control panel, go to Storefront > Script Manager.
  2. Click Create a Script in the top right.
  3. Fill in the form:
    • Name of script: type something you’ll recognise later, for example Amabrik.
    • Description: optional. Something like Amabrik website widgets is fine.
    • Location on page: choose Head.
    • Select pages where script will be added: choose All pages so your widgets can appear anywhere on your store.
    • Script category: choose the category that fits how you use Amabrik. Essential is the usual choice. If you only run optional or marketing widgets, pick the matching category so it respects your cookie banner.
    • Script type: choose Script (paste code), not URL.
  4. In the script box, paste your snippet exactly as copied from the dashboard:
<script async src="https://cdn.amabrik.com/v1/loader.js" data-site="YOUR_SITE_ID"></script>
  1. Click Save.

That’s it. The snippet now loads in the head on every storefront page. Skip ahead to Step 4: Check it’s live.

3. Method B: theme files (optional)

Only do this if you’d rather edit your theme directly. Most stores should use Method A instead.

A word of caution first: theme edits get wiped when you install a new theme or update your current one to a fresh copy. If you go this route, you’ll need to re-paste the snippet after any theme change. Make a backup before you start (on the Themes page, find your current theme, open the Advanced menu, and choose Download or Copy to My Themes so you have a copy to fall back on).

  1. In your control panel, go to Storefront > Themes.
  2. Find your Current Theme at the top. Click the Advanced dropdown (the three dots / chevron next to the theme), then choose Edit Theme Files.
  3. In the file list on the left, open templates > components > common and click header.html. This file holds the content that goes inside your store’s <head>.
  4. Find the closing </head> tag (use the editor’s find with Ctrl + F or Cmd + F and search for </head>).
  5. Place your cursor on the line just above </head>, add a blank line, and paste your snippet there so it sits just before the closing tag:
  <script async src="https://cdn.amabrik.com/v1/loader.js" data-site="YOUR_SITE_ID"></script>
</head>
  1. Don’t change anything else in the file. Click Save & Apply File.

4. Check it’s live

  1. Open your store in a new browser tab. Use a fresh tab or a private window so you’re not seeing a cached page.
  2. Turn on at least one widget in your Amabrik dashboard first (see the next step), then reload your store. The widget should appear.
  3. To confirm the snippet itself loaded: right-click your store page, choose View page source, and use Ctrl + F or Cmd + F to search for amabrik. You should see the script line in the source.

If you prefer, the Install page in your dashboard shows whether your site has been detected.

5. Turn on your widgets

The snippet only tells your store to ask Amabrik what to show. You decide that in the dashboard:

  1. Go to the Widgets page in your Amabrik dashboard.
  2. Pick a widget, set it up, and publish it.
  3. Reload your store. The widget appears within a few seconds.

You can add, edit, pause, or remove widgets any time from the dashboard. None of that needs another change to your BigCommerce store.

Troubleshooting

  • The widget doesn’t show. Make sure you’ve published at least one widget in the dashboard, and that you saved the script. Then reload your store in a private window to skip the browser cache.
  • You don’t see Script Manager. Script Manager sits under Storefront. If it’s missing, your user account may not have permission for it. Ask the store owner to give your account access, or have them add the script. Owner and admin accounts always have it.
  • You don’t see your change right away. BigCommerce and your browser both cache pages. Hard refresh (Ctrl + Shift + R or Cmd + Shift + R) or open a private window.
  • The snippet disappeared after a theme change (Method B). Installing or updating a theme replaces your header.html with a clean copy that doesn’t have your edit. Re-paste the snippet using the Method B steps, or switch to Method A so a theme change can’t remove it.
  • Set the category right. If you run a cookie banner, choose the Script category in Step 2 that matches how the widget is used, so consent rules apply correctly.

FAQ

Should I use Script Manager or theme files?

Use Script Manager. It needs no code, it stays in place when you change themes, and you can remove it in two clicks. Edit theme files only if you have a specific reason to.

Do I need a separate snippet for each widget?

No. The one snippet covers every widget. You control which widgets run, and how, from the dashboard.

Will this slow down my store?

The script is loaded with async, so it doesn’t block your page from rendering. Your store loads first, then the widget appears.

What if I change my theme later?

With Method A (Script Manager), nothing to do, the script keeps running. With Method B, re-paste the snippet into the new theme’s header.html. Either way, your widgets and their settings stay in your Amabrik dashboard.

How do I remove Amabrik from my store?

If you used Script Manager, go to Storefront > Script Manager, find the Amabrik script, and delete it. If you used theme files, open header.html in Edit Theme Files, delete the snippet line, and save.

Last updated June 22, 2026

Want us to install it for you?

Open the Install page in your dashboard and use the Request Installation tab. Our team sets it up for you.

Open Install