Adding Intelligems Script to your Theme

Introduction

Adding the Intelligems script to your site is the most important step to getting started with Intelligems. It's the only integration step you need for Content, Merchandising and Shipping experiences, and it's the first step for Pricing, Checkout and Post-purchase. There are two options below for adding the Intelligems script to your site.

The script is per theme. Whichever option you use, Intelligems has to be live on every theme you want to run an experience on. A brand-new theme starts with the app embed switched off, so a theme change experience needs it enabled on the new theme as well as your current one, and a preview on a draft theme won't load until it's on.

Option 1: Use the App Embed Block

This is the easiest installation method that works for most stores!

The fastest way to add Intelligems JavaScript to your theme is to enable it in the "Customize" section of your theme editor. You can do so by logging into your Shopify Admin, and navigating to Sales Channels > Online Store > Live theme - "Edit Theme" > App Embeds. Search "Intelligems", make sure it is toggled on, and click "Save" in the top right.

This will load Intelligems in a fashion that works optimally for performance and A/B testing on most stores. If for any reason you encounter performance concerns, see our docs on performance optimization.

Here's a video walking through those steps as well:

For any password protected store, we will not be able to automatically detect the script, so you will continue to get an error message in the app regarding the script not being in your theme.

Option 2: Add to Your Theme Code

This will need to be manually removed if you uninstall Intelligems.

In Intelligems, go to Admin Settings and find the Theme script card. Click Copy and your unique Intelligems script is on your clipboard. The Install method line above the button tells you which method we're currently detecting on your store.

Now head over to your Shopify account, and paste the Intelligems Script as a source into the <head> of each of these files:

• theme.liquid

• any other theme.*.liquid files (e.g., theme.gempages.liquid if you have this file)

Here's a video walking through those steps as well:

Pick one method. If you hardcoded the script during an earlier install and have since turned on the app embed, remove the hardcoded copy so Intelligems only loads once.

The script format changed in December 2024. If you're still on the older one, the app flags it, and you'll want to Update the Intelligems Script.

Theme changes and the preview bar. On Checkout Extensibility there's nothing extra to do. Checkout isn't part of your theme, so the theme preview bar can't appear there. If your store still has checkout.liquid, reach out to support and we'll sort the preview bar out with you.