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.

Add a GDPR, ePrivacy and CCPA compliant cookie consent banner to your Bubble.io app. CookieChimp installs from Bubble’s SEO/metatags settings — no plugin install, no workflow changes.
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 Bubble app

  1. Open your app in the Bubble editor.
  2. In the left sidebar, click Settings.
  3. Go to the SEO / metatags tab.
  4. Scroll to the Script/meta tags in header field.
  5. Paste the CookieChimp snippet there. Bubble injects everything in this field into the <head> of every page your app renders.
  6. Click outside the field to save, then Deploy your app to live.
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

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.
Bubble plugins (Google Analytics, Facebook Pixel, Hotjar, Intercom, Mixpanel etc.) inject their own scripts. The cleanest setup is to disable the plugin’s auto-tracking, then add the tracking script manually in Script/meta tags in header with type="text/plain" and a data-category attribute so CookieChimp gates it.
4

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>
In Bubble, you can attach a workflow to a button that triggers HTML with data-cc="show-preferencesModal", or simply enable CookieChimp’s built-in floating Privacy Trigger for a no-code solution.

​
Troubleshooting

  • Banner doesn’t appear — make sure both your bubbleapps.io subdomain and any custom domain are listed in Account Settings → Additional Domains in your CookieChimp dashboard.
  • Banner shows in development but not in live — Bubble requires you to Deploy to live after editing Settings. Verify the snippet exists on the live version, not just the development version.
  • Banner appears twice — you’ve likely added the snippet both in SEO / metatags and on an individual page’s HTML element. Remove the duplicate.
  • 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.
Yes. Bubble apps are single-page applications under the hood — CookieChimp handles the URL changes automatically and won’t re-show the banner on internal navigation. See our SPA guide for advanced patterns.
No. The CookieChimp script is under 30KB gzipped, loads asynchronously and is served from a global CDN. It doesn't block rendering and won't meaningfully affect your Lighthouse scores.
CookieChimp has a free tier suitable for low-traffic sites, with paid plans for higher traffic and additional features. See pricing.