Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.cookiechimp.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

1

Copy your CookieChimp snippet

Log in to your CookieChimp dashboard and copy your website's JS snippet:
<script src="https://cookiechimp.com/widget/abc123.js"></script>
Replace abc123 with your website's unique CookieChimp ID.
2

Add the snippet to your Shopify theme

  1. In your Shopify admin, go to Online Store → Themes.
  2. Click the three-dot menu (⋯) on your current theme and select Edit code.
  3. In the Layout folder, open theme.liquid.
  4. Find the opening <head> tag and paste the CookieChimp snippet directly after it, before any other scripts.
  5. Click Save.
The CookieChimp script needs to be the first script in the <head> section so it can block other scripts before they run and set cookies without consent. If other scripts are added before, they may set cookies and other storage items before consent is granted.
3

Disable Shopify's built-in cookie banner

Shopify’s Customer Privacy banner will conflict with CookieChimp. Turn it off:
  1. Go to Settings → Customer privacy → Cookie banner.
  2. Disable the cookie banner (or set it to inactive on the regions where you’ll use CookieChimp).
CookieChimp now handles consent end-to-end and signals consent to Shopify’s Customer Privacy API so first-party Shopify pixels and Shop Pay tracking respect the user’s choice.
4

Block scripts & cookies

To stay compliant with GDPR and other privacy regulations, you need to actively block non-essential scripts and cookies until the user gives consent. See our Scripts Management Section for full details.
Common third-party tools added through Shopify apps (Klaviyo, Hotjar, TikTok Pixel, Meta Pixel, etc.) are usually injected as <script> tags into theme.liquid or via App Embed Blocks. Update those embeds with type="text/plain" and the matching data-category attribute so CookieChimp can manage them.
5

Configure checkout scripts (Shopify Plus)

Shopify’s checkout pages live on a separate domain and template. If you’re on Shopify Plus and have edited checkout.liquid, repeat step 2 there as well so CookieChimp runs on the checkout flow.
On non-Plus plans, Shopify renders checkout from a managed template you can’t edit. Consent is enforced through the Customer Privacy API, which CookieChimp talks to automatically when installed on your storefront.
6

Allow users to update their preferences

CookieChimp provides a floating privacy icon (Privacy Trigger) that lets users manage cookie preferences at any time. Enable it in the banner settings.To open the preferences modal from a custom button or link, add the data attribute data-cc="show-preferencesModal":
<button type="button" data-cc="show-preferencesModal">
  Manage cookie preferences
</button>
A common pattern is to link to it from your footer menu — Shopify lets you add custom links to menus from Online Store → Navigation.

​
Troubleshooting

  • Make sure the domain is allowed in the Settings page on the CookieChimp dashboard. Both your *.myshopify.com domain and your custom domain should be listed if you want to test on either.
  • If both Shopify’s banner and CookieChimp appear, the Shopify Customer Privacy banner isn’t fully disabled — re-check Settings → Customer privacy → Cookie banner.
  • Clear your browser cache and cookies, then reload your store.
  • Enable Debug mode from the CookieChimp dashboard and check the browser JS console for errors.
If you encounter any issues or need further assistance, please reach out to us via our chat.