Documentation — CookieConsent

Quick Start

Get CookieConsent working on your website in three steps:

Create an account and choose a plan at cookieconsent.io/register
Configure your banner in the dashboard — set colors, text, and cookie categories
Add the embed code to the <head> of your website

Embed Code

Copy your unique embed code from the dashboard and paste it into the <head> tag of every page on your website:

<script src="https://cookieconsent.io/embed/consent-banner.js?site=YOUR_SITE_CODE"></script>

Replace YOUR_SITE_CODE with the site code shown in your dashboard. This code is unique per website or location.

The script loads asynchronously and will not block page rendering.

Verifying Installation

After adding the embed code, visit your website in an incognito/private window. The consent banner should appear. Accept or decline, then check your dashboard — a new consent record should appear within seconds.

Banner Settings

Customise your banner under Settings → Banner in the dashboard:

Primary Color — the background color of the banner
Text Color — color of the text and buttons
Position — bottom bar, top bar, or center modal
Language — controls which language the default text uses
Logo — displayed in the top corner of the banner

Cookie Categories

You can enable or disable up to five cookie categories. Each can have custom description text shown to the user:

Necessary — always enabled, required for basic website function
Analytics — e.g. Google Analytics, Matomo
Marketing — e.g. Meta Pixel, Google Ads
Preferences — language, theme, saved settings
Social Media — embedded content from social platforms

Custom CSS

For advanced styling, paste custom CSS into the Custom CSS field in banner settings. Example:

.consent-banner {
    border-radius: 0;
    box-shadow: none;
}
.consent-banner__title {
    font-size: 1.2rem;
}

Enterprise: Locations

Enterprise accounts can manage multiple locations (websites or physical sites) from one dashboard. Each location gets its own unique embed code.

To add a location, go to Locations → Add Location. Fill in the name, domain, and optional classification fields (category, region, country).

Locations can have three statuses:

Active — the embed code loads normally
Inactive — the embed code is paused (banner will not show)
Closed — the location is permanently closed; a close date is recorded

Enterprise: Location Categories

Categories let you group locations for filtering and reporting. Define your categories at Locations → Manage Categories (one per line). Example categories: Retail, Franchise, Corporate, Warehouse.

Once set, assign a category when creating or editing a location. Reports can then be filtered and broken down by category.

Enterprise: Reporting

The Enterprise Reports page lets you filter consent data by date range, category, location, or country. You can view:

Total consents and acceptance rate
Daily trend chart
Breakdown by category, location, and country

Use the Export CSV button to download a full export of the filtered data for audit or compliance purposes.

API: Authentication

The CookieConsent API uses Bearer token authentication via Laravel Sanctum. Generate a token in your dashboard under Settings → API Tokens.

Authorization: Bearer YOUR_API_TOKEN

API: Check Subscription

Check if the authenticated account has an active subscription:

GET /api/check-subscription

Response:
{
    "subscribed": true,
    "plan": "growth"
}