TermsBox
PricingBlog
LoginGet Started
PricingBlogLogin
Get Started
  1. Home
  2. Blog
  3. Cookie Bot WordPress Setup: Complete Consent Guide
Cookie Policy

Cookie Bot WordPress Setup: Complete Consent Guide

How to set up a cookie bot on WordPress: automatic cookie scanning, prior blocking, consent logging, and the settings that keep you GDPR compliant.

TermsBox Team|July 26, 202613 min read

If you run a WordPress site with visitors in the European Union or United Kingdom, a cookie bot is the practical way to find out what your site actually loads and to stop those trackers from firing before consent. The term "cookie bot WordPress" usually points at one specific product, Cookiebot by Usercentrics, but the underlying idea applies to any consent tool that crawls your pages, builds a cookie inventory, and gates scripts behind a banner. This guide covers what these tools do, how to configure one correctly on WordPress, and the setup mistakes that leave sites non-compliant despite a banner being visible. It is educational rather than legal advice, so consult a qualified attorney for guidance specific to your business.

What a Cookie Bot Is and What It Does on WordPress

A cookie bot is an automated crawler that visits the pages of a website, records every cookie, local storage entry, and tracking script that loads, and classifies each one into a consent category. On WordPress, that output feeds two things: the consent banner your visitors see, and the cookie declaration table you publish on your policy page.

The typical cookie bot performs four jobs:

  • Scanning: crawls your site on a schedule, usually monthly, and logs every cookie set on first load and after interaction.
  • Categorizing: sorts findings into necessary, preferences, statistics, and marketing based on a vendor database.
  • Blocking: prevents non-essential scripts from executing until the visitor gives consent.
  • Logging: stores a timestamped record of each consent decision as evidence, which GDPR Article 7(1) requires you to be able to produce.

The blocking step is the one that carries legal weight. A banner that shows a message but lets Google Analytics fire on page load is decoration, not compliance.

Why WordPress Sites Need Cookie Consent

The core rule comes from Article 5(3) of the ePrivacy Directive (2002/58/EC, as amended by 2009/136/EC). It requires informed consent before storing or accessing information on a user's device, with a narrow exemption for storage that is strictly necessary to deliver a service the user explicitly requested. The GDPR then defines what valid consent looks like: freely given, specific, informed, and unambiguous under Article 4(11), with a withdrawal that is as easy as giving it under Article 7(3).

WordPress makes this harder than it looks because cookies arrive from places you did not choose:

  • Theme and page builder assets: Elementor, Divi, and similar builders set functional cookies and often load Google Fonts from a third-party origin.
  • Embeds: a single YouTube embed sets marketing cookies on the youtube.com and doubleclick.net domains unless you use the no-cookie variant.
  • Plugins: contact forms with reCAPTCHA, chat widgets, analytics plugins, and e-commerce carts each contribute their own storage.
  • Tag managers: Google Tag Manager containers can inject tags that no one on your team documented.

The Court of Justice of the European Union confirmed in Planet49 (Case C-673/17, October 2019) that pre-ticked boxes do not constitute consent. The EDPB Guidelines 05/2020 on consent added that continued scrolling and continued browsing are not valid consent signals either. Both rulings shape how your cookie bot must be configured, not just whether you have one.

Enforcement is real. GDPR Article 83 allows fines up to 20 million EUR or 4 percent of global annual turnover, whichever is higher. Cookie-specific penalties are issued under national ePrivacy implementations and vary by member state, but the CNIL in France fined Google 150 million EUR and Facebook 60 million EUR in January 2022 specifically because refusing cookies took more clicks than accepting them.

How a Cookie Bot Scans a WordPress Site

Understanding the crawl helps you interpret the results. A scan generally follows this sequence:

  1. The crawler requests your homepage with a clean browser profile and no stored consent.
  2. It records every cookie set before any interaction, which becomes your "prior to consent" list.
  3. It follows internal links up to the page limit on your plan.
  4. It simulates consent and records the additional cookies that then appear.
  5. It matches each cookie name against a vendor database to assign a purpose, provider, and expiry.

Two practical limits matter on WordPress. First, crawlers see only what a logged-out visitor sees, so cookies set inside a members area, a WooCommerce checkout, or a gated course will be missed unless you provide credentials or add them manually. Second, page limits bite hard on content sites: a blog with 4,000 posts scanned at a 500-page limit gives you a partial inventory, and partial is what regulators judge you on.

Cookies a Scan Commonly Misses

  • Cookies set only after a form submission or a video play.
  • Cookies from A/B testing tools that show a variant to a fraction of sessions.
  • Server-side cookies set by PHP with setcookie() inside a plugin, which a client-side crawler may or may not attribute correctly.
  • Cookies from ad networks that rotate domains.

Treat the scan as a strong first draft, then verify it manually in your browser's Application or Storage tab with a clean profile.

Setting Up a Cookie Bot on WordPress Step by Step

The installation flow is similar across vendors. Using Cookiebot as the reference implementation:

  1. Register the domain in the vendor dashboard and run the first scan. Review the classification of every cookie before publishing anything, since automatic categorization gets custom and first-party cookies wrong regularly.
  2. Install the plugin from the WordPress repository and paste your domain group ID or CBID into the settings screen.
  3. Enable automatic prior blocking. In Cookiebot this rewrites known third-party script tags to type="text/plain" with a data-cookieconsent category attribute so the browser will not execute them until consent is recorded.
  4. Tag any scripts the bot did not catch. Add data-cookieconsent="marketing" and change the type attribute manually on hard-coded scripts in your theme, child theme, or a code snippets plugin.
  5. Place the cookie declaration on your cookie policy page with the provided shortcode, then add the surrounding policy text the shortcode does not generate.
  6. Add a persistent renew link in the footer so visitors can change or withdraw their choice at any time, which Article 7(3) requires.
  7. Re-scan and verify with a fresh incognito window, checking that no statistics or marketing cookies appear before you click accept.

Step seven is the one people skip. A banner that renders correctly proves nothing about what fired underneath it.

Verifying Prior Blocking Actually Works

Open your site in a private window, open DevTools before the page loads, and check three things: the Application tab for cookies present prior to any click, the Network tab for requests to analytics or ad domains, and the Console for consent script errors. If _ga or _fbp exists before consent, blocking is not working, no matter what the plugin settings say.

Cookie Bot Options for WordPress Compared

Tool Automatic scanning Prior blocking Consent log Best fit
Cookiebot (Usercentrics) Yes, scheduled crawl Yes, automatic plus manual tagging Yes, exportable Sites wanting a mature vendor database
Complianz Yes, on-site scan Partial, plugin-integration based Yes, in database WordPress-native setups with common plugins
CookieYes Yes, scheduled crawl Yes, script-level Yes Small sites on a budget
Manual custom code No Only what you write Only what you build Single-purpose sites with two or three scripts
TermsBox Yes, scanner plus CMP Yes, category-gated Yes Sites that want the scan to also update the policy document

The differentiator worth weighing is what happens after the scan. Most tools give you a table. The gap that causes compliance drift is the policy text around the table, which stays frozen at whatever you wrote on setup day while your tracker list keeps changing. For a broader look at plugin choices, the guide to WordPress cookie consent plugins covers the WordPress-specific options in more depth.

Cookie Bot WordPress Settings That Break Compliance

Most non-compliant WordPress sites have a correctly installed cookie bot and one or two wrong settings. These are the recurring ones.

Accept-only banners. If the first layer shows only an "Accept" button and reject requires opening preferences, you have built exactly the asymmetry the CNIL fined Google and Facebook for. Reject must be available at the same layer with equal prominence.

Pre-ticked category toggles. Statistics and marketing must default to off. Planet49 settled this, and it remains the single most common finding in EU regulator sweeps.

Cookie walls. Blocking content entirely until the visitor accepts marketing cookies undermines the "freely given" requirement in Article 4(11). EDPB Guidelines 05/2020 treat most cookie walls as invalid consent.

Implied consent language. Copy that reads "by continuing to browse you agree" is not consent under the GDPR. Replace it.

Caching conflicts. WP Rocket, LiteSpeed Cache, and Cloudflare APO can serve a cached page whose consent state belongs to a different visitor. Exclude the consent script from optimization, minification, and combination, and confirm your cache does not vary the banner state incorrectly.

Deferring the consent script. Moving the consent script to async or defer improves your Largest Contentful Paint and creates a window where tracking scripts execute before consent is evaluated. Fix Core Web Vitals somewhere else.

Cookie Policy Generator

Create a cookie policy for GDPR compliance. Create yours in minutes with TermsBox.

Generate Now

Connecting a Cookie Bot to Google Consent Mode v2

Since March 2024, Google requires Consent Mode v2 signals for advertisers serving EU and UK traffic through Google Ads and personalized advertising features in Analytics 4. Without the ad_user_data and ad_personalization parameters, remarketing audiences stop populating for European traffic.

Your cookie bot handles this by setting default consent states before the Google tag loads, then updating them when the visitor decides:

  • ad_storage, analytics_storage, ad_user_data, and ad_personalization all default to denied for EU and UK visitors.
  • The consent update fires immediately on the visitor's choice, not on the next page view.
  • Cookieless pings still reach Google in denied state, which is why modeled conversions appear even for visitors who refuse.

The ordering is what fails in practice. If your Google Tag Manager container loads before the consent default command runs, the first hit goes out with no consent signal at all. Check the Tag Assistant consent tab or run the Google Consent Mode v2 setup steps to confirm the defaults land first.

Keeping Your WordPress Cookie Policy in Sync

A scan gives you a table of cookie names, providers, purposes, and expiries. That satisfies part of the transparency duty in GDPR Articles 13 and 14, but it is not a cookie policy on its own. A complete policy also states:

  • The legal basis for each category, with consent under Article 6(1)(a) for non-essential cookies and legitimate interests or contractual necessity for strictly necessary ones.
  • The identity of third-party recipients and what they do with the data.
  • International transfer mechanisms where a vendor processes data outside the EEA, under Chapter V of the GDPR.
  • How to withdraw consent, with a working link.
  • California disclosures if the CCPA applies to you, meaning 25 million USD in annual gross revenue, personal information of 100,000 or more consumers or households, or 50 percent or more of revenue from selling or sharing personal information.

The maintenance problem is straightforward: your tracker list changes every time you install a plugin, and your policy text does not. A cookie policy generator gives you the surrounding legal structure the scan table cannot produce, and on TermsBox paid plans the document regenerates when the scanner detects a new tracker rather than waiting for you to notice. Starter is 12 USD per month per site with monthly scans, and Pro is 25 USD per month with weekly scans and unlimited banner views.

If your site serves both EU and US visitors, review the overlap between cookie consent and broader disclosure duties in the GDPR and cookies breakdown before finalizing the policy text.

Alternatives to a Third-Party Cookie Bot

A hosted cookie bot is not the only route, and it introduces its own considerations. In November 2021 the Wiesbaden Administrative Court issued an interim injunction against a university's use of Cookiebot on the grounds that visitor IP addresses reached a US-based content delivery network before consent. The Hessian Higher Administrative Court suspended that decision on appeal in early 2022, and the EU-US Data Privacy Framework adopted in July 2023 changed the transfer landscape again. The episode still illustrates the point that a consent tool itself processes personal data.

Reasonable alternatives depending on your setup:

  1. Self-hosted consent scripts where the CMP assets load from your own domain, removing the pre-consent third-party request entirely.
  2. Manual blocking for small sites with fewer than five tracking scripts, where a hand-written gate is auditable and cheap.
  3. Removing the trackers you cannot justify. Every tag you delete is one fewer consent problem, one fewer vendor in your policy, and a faster site.

Option three is underrated. Many WordPress sites carry heatmap tools, abandoned pixels, and duplicate analytics installs that nobody has looked at in two years.

Frequently Asked Questions

What does a cookie bot do on a WordPress site?

A cookie bot crawls your WordPress site, records every cookie and tracker that loads, sorts them into categories such as necessary, preferences, statistics, and marketing, and feeds that list into a consent banner and cookie declaration. It then blocks non-essential scripts until the visitor consents, which is what Article 5(3) of the ePrivacy Directive requires.

Is the Cookiebot WordPress plugin free?

Cookiebot offers a free tier limited to small domains by page count, with paid plans for larger sites and for features like consent logging exports and multiple domains. Free tiers across all cookie bot vendors usually cap monthly banner impressions or scanned pages, so check the limit against your traffic before you commit.

Does a cookie bot block cookies automatically on WordPress?

Only if you enable automatic prior blocking and the bot can recognize the script. Automatic blocking works well for common tags like Google Analytics, Meta Pixel, and YouTube embeds, but server-side cookies set by PHP plugins and hard-coded custom scripts usually need manual tagging or a manual block rule.

Do I still need a cookie policy if I use a cookie bot?

Yes. The scan output is a cookie declaration table, which covers the transparency requirement in GDPR Articles 13 and 14 only in part. You still need a cookie policy that explains your legal basis, retention periods, third-party recipients, international transfers, and how visitors withdraw consent under Article 7(3).

Will a cookie consent plugin slow down my WordPress site?

The consent script is render-blocking by design, because it must run before any tracking script fires, so it adds roughly 20 to 60 milliseconds plus network latency on most sites. Do not defer or async the consent script to improve Core Web Vitals, since that creates a window where trackers fire before consent is recorded.

What happens if my cookie bot scan misses a cookie?

You are still liable. Regulators assess the actual behavior of your site, not the accuracy of your vendor's crawler, so an undeclared marketing cookie is an ePrivacy violation regardless of why it was missed. Re-scan after every plugin, theme, or tag manager change and spot-check with your browser's Application tab.

Related Tools

Cookie Policy Generator

Create a cookie policy for GDPR compliance

Related Articles

Cookie Policy

EU Cookie Law Explained: Requirements, Consent, and Compliance

Learn what the EU cookie law requires from your website. Covers the ePrivacy Directive, GDPR consent rules, exemptions, penalties, and compliance steps.

July 25, 202613 min read
Cookie Policy

European Cookie Law Explained: ePrivacy, GDPR, and Consent

Understand the European cookie law: how the ePrivacy Directive and GDPR regulate cookies, what valid consent requires, and how to make your site compliant.

July 25, 202612 min read
Cookie Policy

EU Cookie Law Guide: Consent Rules and Compliance in 2026

Understand the EU cookie law: which cookies need consent, what a valid banner looks like, penalties for violations, and how to comply with EU cookies rules.

July 24, 202614 min read

Ready to Create Your Legal Documents?

Generate professional privacy policies, terms of service, and more in minutes. Free to start, no credit card required.

View All Generators

On This Page

  • What a Cookie Bot Is and What It Does on WordPress
  • Why WordPress Sites Need Cookie Consent
  • How a Cookie Bot Scans a WordPress Site
  • Cookies a Scan Commonly Misses
  • Setting Up a Cookie Bot on WordPress Step by Step
  • Verifying Prior Blocking Actually Works
  • Cookie Bot Options for WordPress Compared
  • Cookie Bot WordPress Settings That Break Compliance
  • Connecting a Cookie Bot to Google Consent Mode v2
  • Keeping Your WordPress Cookie Policy in Sync
  • Alternatives to a Third-Party Cookie Bot
  • Frequently Asked Questions
TermsBox

Scan your website, auto-generate legal documents, add a consent banner, and stay compliant. One platform for everything.

Product
  • Cookie Scanner
  • Consent Banner
  • Cookie Policy Generator
  • Pricing
Generators
  • Privacy Policy Generator
  • Terms and Conditions Generator
  • EULA Generator
  • Disclaimer Generator
  • Return and Refund Policy Generator
Company
  • About
  • Contact
  • Privacy Policy
  • Terms of Service
  • Cookie Policy
GDPR
ePrivacy
CCPA
LGPD
Google Consent Mode v2
IAB TCF 2.2
© 2026 TermsBox. All rights reserved.