How to add Amabrik to Shopify

Amabrik runs on your Shopify store from one small snippet. You paste it once into your theme, 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 theme 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>

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.

2. Check your Shopify plan first

You add custom code by editing your theme, and that needs a plan with a full themed storefront. That means Basic or higher.

The Starter plan does not work for this. On Starter you get a simplified store on the single Spotlight theme, with no code editing, so there’s nowhere to paste the snippet. If you’re on Starter and want Amabrik on your store, upgrade to Basic or higher first. You can confirm your plan under Settings > Plan in your Shopify admin.

3. Add the snippet to your theme

1. In your Shopify admin, go to Online Store > Themes.
2. Find your active theme (the one marked “Current theme”). Click the three dots (the ... button) next to it, then click Edit code.
3. In the file list on the left, open the Layout folder and click theme.liquid to open it. (Shortcut: press Ctrl + P on Windows or Cmd + P on Mac, type theme.liquid, and select it.)
4. Find the closing </head> tag near the top of the file. You can search the file with Ctrl + F or Cmd + F and type </head>.
5. Click at the start of the line with </head>, press Enter to make a blank line above it, then paste your snippet on that blank line. It should sit just before </head>:

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

Don’t change or delete anything else in the file. In particular, leave the content_for_header line alone, Shopify needs it.

4. Save

Click Save in the top right of the code editor. Shopify saves the change to your live theme right away.

5. 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.

6. 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 Shopify theme.

Troubleshooting

• The widget doesn’t show. Make sure you’ve published at least one widget in the dashboard, and that you saved theme.liquid. Then reload your store in a private window to skip the browser cache.
• You don’t see your change right away. Shopify and your browser both cache pages. Hard refresh (Ctrl + Shift + R or Cmd + Shift + R) or open a private window.
• A theme update removed the snippet. Installing a new theme, or replacing your theme with a fresh copy, gives you a clean theme.liquid without your edit. After any theme change, re-paste the snippet using the steps above.
• Play it safe before editing. On the Themes page, click the three dots next to your theme and choose Duplicate first. That gives you a backup copy you can fall back to if something goes wrong while editing.
• You can’t find Edit code. You’re likely on the Starter plan, which has no code editor. Upgrade to Basic or higher (Step 2).

FAQ

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.

Can I use Amabrik on the Shopify Starter plan?

No. Starter has no theme code editor, so there’s no way to add the snippet. You need Basic or higher.

What if I change my theme later?

Re-paste the snippet into the new theme’s theme.liquid, just before </head>. Your widgets and their settings stay in your Amabrik dashboard, so nothing else needs redoing.

How do I remove Amabrik from my store?

Open theme.liquid in Edit code, delete the snippet line, and click Save.