Overview
Kukie is fully compatible with WP Rocket. As of Kukie WordPress plugin version 1.5.0, all four WP Rocket JavaScript optimisation features are handled automatically - no manual configuration is required for default WP Rocket setups.
How it works (v1.5.0 and later)
The Kukie WordPress plugin programmatically excludes its CDN script (cdn.kukie.io) from WP Rocket's JavaScript optimisations using WP Rocket's own filter hooks:
- Minify JavaScript files
- Combine JavaScript files
- Load JavaScript deferred
- Delay JavaScript execution
These exclusions are applied at runtime per request, so they take effect without writing to WP Rocket's stored settings and without requiring you to touch WP Rocket's UI. The Kukie banner script will load correctly out of the box on any site running both plugins in their default configurations.
Symptoms of a broken setup
If WP Rocket is somehow still interfering with your cookie banner, you may notice:
- The cookie banner does not appear on your site
- The banner appears briefly then disappears
- The banner loads after a delay (only after scrolling or clicking)
- Cookies are set before the visitor has given consent
When manual configuration may be needed
In rare cases you may still need to add cdn.kukie.io to WP Rocket's exclusion fields manually:
- You are using Kukie plugin v1.4.x or earlier (upgrade to v1.5.0+ to fix this)
- A third-party plugin or custom code interferes with Kukie's filter callbacks
- You want the exclusions to be visible in WP Rocket's settings UI for audit or compliance purposes
- You are using a non-standard WP Rocket configuration that bypasses runtime filters (uncommon)
If the Kukie admin notice appears warning about WP Rocket compatibility, follow the steps below.
Manual configuration (if needed)
Step 1: Open WP Rocket settings
In your WordPress admin, go to Settings > WP Rocket > File Optimisation.
Step 2: Add exclusions for each enabled feature
For every JavaScript optimisation feature you have enabled, add cdn.kukie.io to the corresponding exclusion field:
| WP Rocket feature | Exclusion field |
|---|---|
| Minify JavaScript files | Excluded JavaScript Files |
| Combine JavaScript files | Excluded JavaScript Files |
| Load JavaScript deferred | Excluded JavaScript Files (Defer JS) |
| Delay JavaScript execution | Excluded from Delay JavaScript Execution |
Add the following line to each relevant field:
cdn.kukie.ioStep 3: Save changes
Click Save Changes at the bottom of the WP Rocket settings page. WP Rocket automatically clears its cache when you save, so no separate cache-clearing step is needed.
Step 4: Verify
Open your site in an incognito or private browser window and confirm the Kukie consent banner appears. If it does not, double-check that cdn.kukie.io is listed in all the exclusion fields above for the features you have enabled.
Troubleshooting
If the banner still does not appear after manual configuration:
- Confirm the Kukie plugin is at the latest version (currently 1.5.0+)
- Disable WP Rocket temporarily and confirm the banner appears - this isolates whether WP Rocket is the cause
- Check the browser console for any JavaScript errors
- Contact support at support@kukie.io with your site URL and a description of what you are seeing
Need Help?
If you have followed these steps and your banner is still not loading, contact our support team and include the URL of your site so we can investigate.
