About this plugin
ClearCrumb shows a fast, accessible cookie banner and stores each visitor’s choice in their own browser.
- Auto-blocking: your services’ scripts and embeds wait for consent, even on cached pages.
- Switching? Import your settings from Complianz, CookieYes or Cookiebot.
- A two-minute setup wizard: regions, scan, services, design.
- Works with WPML, Polylang and TranslatePress.
- Banner in 16 languages (EN, DE, FR, NL, ES, IT, PT, PL, SV, DA, FI, NO, CS, RO, AR, HE), picked from your site language, right-to-left included.
- A cookie policy page that keeps itself up to date: [clearcrumb_cookie_policy], in English, German, French, Dutch, Spanish and Italian.
- A cookie scanner that checks up to 50 pages and finds the services your site uses.
- A Leak Test that shows what still loads before consent.
- A Compliance Score from 0 to 100 that tells you what to fix.
- A consent checkbox for Contact Form 7 and WPForms forms.
- A consent log in your own database: proof of every choice, kept as long as you choose (30 days to forever), with hashed IDs and IPs, and a CSV export.
- Region rules: GDPR opt-in for the EU, EEA, UK and Switzerland, US opt-out with Global Privacy Control.
- Google Consent Mode v2 (basic and advanced), Microsoft UET Consent Mode, Meta Pixel and TikTok Pixel consent APIs and the WP Consent API.
- Placeholders for blocked videos and maps, with a locally stored thumbnail and a “Load video” button.
- A library of 155 common services with their cookies, so visitors see who is behind each choice.
- Four banner layouts and six design styles, with a live preview while you edit.
- Accept, Reject and Preferences with four categories: necessary, preferences, statistics and marketing.
- Reject always looks exactly like Accept. Saying no is never harder than saying yes.
- A floating “cookie settings” button and a [clearcrumb_preferences] shortcode, so visitors can change their mind at any time.
- Small and quick: no jQuery, no external requests, the banner script loads deferred.
- Settings export and import as a JSON file, to set up your next site in seconds.
- WP-CLI commands: wp clearcrumb scan and wp clearcrumb log export.
- A dashboard widget with this week’s consent rate.
- Block-editor blocks: Cookie policy and Cookie settings link.
- Keyboard and screen-reader friendly (WCAG 2.2 AA target).
ClearCrumb helps you meet cookie rules but is not legal advice.
For developers
open()` opens the preferences. Every saved choice fires a `clearcrumb:consent` event on `document`.
Source code & build
Everything ships readable. css ). The admin app’s source is in src/admin/, with the build tools in src/tools/.
js 18 or newer):
npm install && npm run build
External services
ClearCrumb sends nothing about your visitors anywhere. Your server contacts two services only to fetch a video thumbnail for the placeholder that replaces a blocked embed, once per video, in the background:
- YouTube (Google): when a page contains a blocked YouTube embed, your server downloads the video’s thumbnail image from i.ytimg.com. Only the video ID is sent. Terms of Service · Privacy Policy
- Vimeo: when a page contains a blocked Vimeo embed, your server asks vimeo.com/api/oembed.json for the thumbnail address and downloads the image from i.vimeocdn.com. Only the video ID is sent. Terms of Service · Privacy Policy
The thumbnails are stored in your uploads folder and shown from your own site, so visitors’ browsers contact neither service before they consent.