Skip to content
Start free Sign in

Configure the WordPress plugin

Last updated

After connecting the WordPress plugin to your Kukie.io account, you can configure the most common settings directly from the WordPress admin without logging into the Kukie.io dashboard. Everything the plugin saves is stored in your Kukie.io account, so the plugin and the dashboard never disagree. For a full overview of plugin features, visit kukie.io/wordpress.

The plugin menu

Since plugin version 1.8.0 the Kukie entry in the WordPress admin sidebar has four pages:

  • Dashboard - banner status, consents today, plan, verification and accessibility widget state, plus consent totals and the last cookie scan.
  • Consent banner - eight tabs: Design (layout, position, revisit button, live preview), Preferences modal, Behaviour, iFrame blocking, Language, Google Consent Mode v2, Microsoft UET and Regions (a link to the region rules on Kukie.io). Bookmarks to the older separate Banner Design, Google Consent Mode v2 and Microsoft UET pages redirect to the matching tab.
  • Accessibility widget - switch on and configure the Kukie accessibility widget for this site.
  • Uptime monitoring - on plans that include it, the monitor's basic settings and its recent checks.
  • Settings - banner script on/off, script position, hide for administrators and the connection details.

Finding Your Site Key

Your site key is displayed on the Kukie.io dashboard when you open your site. You can find it under Settings → Site Key on the site overview page, and on the plugin's Settings page under Connection. The site key is a UUID that identifies your site and is embedded in the banner script.

The Design tab lets you pick the banner layout (popup, bottom bar, top bar, floating), its position for the floating layout, and every revisit-button option (position, style, icon, text, colours, offsets) with a live preview. Colours, texts, categories, custom CSS and the banner logo are managed in the Kukie.io Banner Editor; changes there are applied to your WordPress site automatically, no plugin update needed.

Consent banner: Google Consent Mode v2

The Google Consent Mode v2 tab has one switch, for Google Consent Mode v2. It is the same setting as the switch in the Banner Editor's Integrations tab, so turning it on in either place turns it on for the site. With it on, the banner tells Google tags the consent state before a visitor chooses and sends an update when the visitor makes a choice, so Google Analytics, Google Ads and other Google tags adjust what they collect without any extra code. Script blocking is on the Behaviour tab.

From plugin 1.10.0, while Consent Mode is on, the tab also shows Google's banner text: what Google's EU user consent policy asks a banner to say, and an Apply Google's banner text button. The button does the same as the one in the Banner Editor: Google's text goes into every language of your banner, and Accept all, Reject all and Manage preferences are turned on. Applying replaces the banner description you have now, so the plugin asks first. Once the text is applied, the tab tells you when a language or a region no longer has all of it, with a Re-apply Google's banner text button. See Google's banner requirements.

What Google tags assume before a visitor chooses depends on the visitor's region rule, set in the Banner Editor's Regions tab. Google tags start with consent denied, regions whose rule allows cookies until the visitor chooses get a granted default, and while the banner is on screen no consent update is sent until the visitor makes a choice. A Google Tag Manager container ID is entered in the Banner Editor's Integrations tab, not in the plugin.

Consent banner: Microsoft UET

The Microsoft UET tab has a single toggle that forwards visitor consent choices to Microsoft Advertising Universal Event Tracking tags.

Accessibility widget

The Accessibility widget page switches on the Kukie accessibility widget for this site and mirrors the dashboard's settings: position, button size, colour (or inherit the banner theme), hide on mobile, which modules visitors see, which languages the panel offers and its default language, and the accessibility statement link. The widget is delivered inside the same Kukie script as the banner, so there is nothing extra to install. Panel texts are reworded per language in the dashboard.

The widget is a plan feature. On plans without it the page explains what the widget does and which plan includes it, with an upgrade link; the settings are shown but cannot be saved. Changes take effect once the banner script cache refreshes, usually within a minute or two.

Language Settings

On the Settings page, Banner language follows WPML, Polylang or the WordPress site language automatically, or forces one language. Auto-Translate, the default language and the enabled languages sync to your Kukie.io account. Custom text overrides and RTL support are managed in the Banner Editor's Texts & Languages tab - see Configure Texts & Languages.

Region Rules

The consent model shown to each visitor depends on their detected region. You can configure region-specific rules (opt-in for EU, opt-out for US, etc.) in the Banner Editor's Regions tab. See Region Rules & Geo-Detection for full details.

Script Position

Choose where the banner script is injected in your WordPress pages:

  • Head - uses the wp_head hook. Recommended for best auto-blocking performance.
  • Body - uses the wp_footer hook. Use this if you experience conflicts with other head scripts.
  • Manual - the plugin injects nothing; copy the embed code shown on the page into your theme's header template.

Triggering Scans from WordPress

Click Run New Scan on the plugin dashboard to trigger a cookie scan. The scan runs on the Kukie.io servers (using the same fan-out scanner architecture), not on your WordPress server. The dashboard refreshes its data every minute and shows the result when the scan completes.

Scan limits follow your plan's settings (maximum pages per scan, scan queue limits).

Verifying Installation

Click Verify on the plugin's Settings page to confirm that the banner script is properly loaded on your site. The plugin sends a verification request to Kukie.io, which fetches your homepage and checks for the presence of the c.js script with your site key.

Dashboard Data and Sync

The plugin caches dashboard data (consent stats, last scan info) for 5 minutes to minimise API calls, and refreshes it every minute while the Dashboard page is open. Settings changes sync to Kukie.io in real time.

Follow this guide in your own account

Create a free account to follow this guide: add your site, scan it for cookies and publish your consent banner.

Start free
Was this helpful?

Listed on