Skip to content

Documentation

Configure WordPress Plugin Settings

Configure WordPress Plugin Settings

Last updated Mar 24, 2026

After connecting the WordPress plugin to your Kukie.io account, you can configure several settings directly from the WordPress admin without logging into the Kukie.io dashboard. For a full overview of plugin features, visit kukie.io/wordpress.

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. The site key is a UUID that identifies your site and is embedded in the banner script. You entered this key when you first connected the plugin.

Google Consent Mode v2

The plugin settings page includes a toggle for Google Consent Mode v2 (GCM v2). When enabled, the banner script automatically fires gtag('consent', 'default', ...) and gtag('consent', 'update', ...) calls based on your visitors' consent choices. This lets Google Analytics, Google Ads, and other Google tags adjust their behaviour without any additional code on your part.

Enabling GCM v2 in the plugin is equivalent to toggling it on in the Banner Editor's Integrations tab. The setting syncs to your Kukie.io account automatically.

Google Tag Manager Container ID

If you use Google Tag Manager, enter your GTM container ID (e.g. GTM-XXXXXXX) in the plugin settings. The banner script will inject the GTM container snippet at the correct point in the consent flow, ensuring all tags respect consent choices from the very first event. You do not need to add the GTM snippet manually to your theme.

Language Settings

The plugin respects the language configuration set in the Kukie.io dashboard. To change which languages your banner supports, add or remove languages in the Banner Editor's Texts & Languages tab. See Configure Texts & Languages for details on managing translations, custom text overrides, and RTL support.

Banner design - including layout, colours, logo, and custom CSS - is managed entirely from the Kukie.io dashboard. Changes you make in the Banner Editor are applied automatically to your WordPress site. No plugin update is needed when you change the design.

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.

Triggering Scans from WordPress

Click Run 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 plugin polls for scan progress and displays results when complete.

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

Verifying Installation

Click Verify Installation 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. Click Refresh to fetch the latest data manually. Settings changes sync to Kukie.io in real time.

Was this helpful?