Troubleshooting & Compatibility

Practical notes for getting CookieRay working cleanly alongside caching, other plugins, and your site setup.

Caching plugins

The CookieRay banner initializes from front-end scripts after the page loads, so it works alongside common caching plugins, including:

• WP Super Cache
• W3 Total Cache
• WP Rocket
• LiteSpeed Cache
• SG Optimizer

That said, every site’s caching rules differ. Always verify the banner appears and behaves correctly with your specific caching configuration after enabling or changing rules.

Multisite

This release targets standard single-site WordPress installs. Network-wide multisite is not supported in this release.

Conflicts with other consent plugins

Running two consent plugins at the same time can cause problems — duplicate banners, or the plugins fighting over script interception. While evaluating CookieRay, disable any overlapping consent plugins so they don’t interfere with each other.

Scan coverage

CookieRay’s scanner combines a server-side crawl that sees what an unauthenticated visitor can see with a browser check in your own admin session, so coverage is limited by:

• Caches that change what pages return.
• Authenticated-only flows the crawler cannot reach.
• Whatever the unauthenticated crawler can actually crawl.

Keep this in mind when reviewing scan results — pages behind login or only triggered by logged-in interactions may not be fully covered.

Geo targeting has no effect (Pro)

Geo targeting needs a country header from your host or CDN (or the PHP GeoIP extension). If none is available, or the country can’t be detected, the banner is shown to everyone. Page caching can also serve one country’s result to others. Remember too that in a hidden country the banner, consent signals and browser-side blocking are off, while server-side blocking in Strict mode and the Pro integration tags are not switched off by geo rules. See Geo Targeting.

A Pro panel is locked

Pro panels need the free plugin, the Pro add-on, and an active license. Check the License screen under CookieRay (labeled Upgrade to Pro until a license is active). See License activation.

Still stuck?

Contact us with your WordPress version, CookieRay version, and what you expected to happen. Free plugin users can also use the WordPress.org support forum.

Comparing modes during troubleshooting

When diagnosing compatibility issues, compare Strict vs Log Only behavior alongside your caching and optimization stack. Switching to Log Only temporarily can help isolate whether a problem comes from script delaying or from another part of your setup.

CookieRay is not legal advice. Compliance depends on your configuration and the rest of your site.