CookieRay
Settings
This page walks through each CookieRay setting and explains where the values are stored in your WordPress database. Use it as a reference when configuring consent behavior, expiry, retention, and Google Consent Mode v2.
Consent behavior: Log Only vs Strict blocking
CookieRay offers two consent-handling modes:
- Log Only — CookieRay records what would have happened but does not interfere with script loading. Known trackers are not delayed; the plugin simply writes consent and inventory records. Use this mode while evaluating the plugin or comparing behavior against another stack.
- Strict blocking — CookieRay delays known trackers until the visitor grants the relevant category. Scripts in regulated categories are held back until consent is recorded.
When troubleshooting compatibility, it can help to compare Strict and Log Only behavior side by side alongside your caching and optimization stack.
Consent expiry
Controls how long a visitor’s recorded consent choice remains valid before they are asked again. Once a stored consent passes its expiry, the banner re-prompts the visitor on their next visit.
Consent log retention period
Sets how long CookieRay keeps individual consent audit records. A scheduled WP-Cron job deletes consent records older than the configured retention period, so this value directly governs how much audit history is retained in your database.
Google Consent Mode v2 toggle
Enables or disables Google Consent Mode v2 signaling. When enabled, CookieRay communicates the visitor’s consent state in the format Google’s tags expect, so Google services can adjust their behavior based on the granted categories.
Banner enable / disable
The banner can be turned on or off. Note that banner_enabled is stored inside cookieray_settings (not in the banner settings option).
Optional data portability / export flows
CookieRay can export your consent records for portability and record-keeping. Exports include CSV data and PDF consent receipts. These flows are optional and run on demand — nothing is exported automatically.
Where settings are stored
CookieRay persists configuration in standard WordPress options:
| Option key | Purpose |
|---|---|
cookieray_settings | Core plugin settings, including consent behavior, expiry, retention, Consent Mode v2, and banner_enabled. |
cookieray_banner_settings | Banner appearance and presentation settings. |
cookieray_db_version | Tracks the installed database schema version for upgrades. |
Because these are normal WordPress options, they travel with your database backups and migrations.
CookieRay is not legal advice. Whether your configuration meets a given regulation depends on how you set these options and the rest of your site.