Quick Start

Get CookieBoss running on your website in five steps.

1. Create an account

Sign up at app.cookieboss.io/signup. No credit card required — the free plan includes 1 domain and 50 subpages, plus a 14-day Pro trial.

2. Add your site

After logging in, click Add Site and enter your domain (e.g. example.com). CookieBoss will create a unique site ID and script URL for you.

3. Copy the script tag

Go to your site’s detail page and copy the script snippet. It looks like this:

Add to your <head> html 
<script async src="https://cdn.cookieboss.io/scripts/YOUR_SITE_ID/consent.js"></script>

Paste it into the <head> of every page on your site, before any analytics or marketing scripts.

Why before other scripts?

CookieBoss blocks third-party scripts until the visitor gives consent. For this to work, the consent script must load first.

4. Configure your banner

In the dashboard, open the Banner Editor for your site. Here you can:

  • Choose a layout: bottom bar, modal, or preference center
  • Set your brand colors (primary, accent, background, text)
  • Edit the consent text and button labels
  • Enable Google Consent Mode V2 if you use Google Analytics or Ads
  • Configure geo rules for GDPR (EU) and CCPA (California) compliance

Click Save when you’re done.

5. Publish

Click the Publish button. CookieBoss compiles a custom script for your site and deploys it to the CDN. Within seconds, your consent banner will appear for visitors.

Script URL never changes

The script URL stays the same across publishes. Each publish creates a new version — visitors automatically get the latest configuration without any code changes on your end.

Verify it works

Open your website in a private/incognito browser window. You should see the consent banner. Try:

  1. Accept All — the banner dismisses, cookies are set normally
  2. Clear cookies and reload — the banner reappears
  3. Reject All — third-party scripts are blocked
  4. Open the browser console and type window.__cookieboss.getConsent() to inspect the current consent state

Next steps