Different regions have different privacy laws, and your cookie banner should adapt accordingly. Kukie.io's region rules let you configure separate consent models, button visibility, dismiss behaviour, and more for each geographic region. When a visitor loads your site, their location is detected automatically and the correct rule is applied.
The Default Rule
Every site has a default region rule that is created automatically when you add the site. This rule applies to all visitors whose location does not match any specific region rule. It cannot be deleted.
The default rule is typically set to Opt-in as a safe baseline - any visitor from an unrecognised region receives the strictest consent model.
Adding Region-Specific Rules
In the Banner Editor, switch to the Regions tab. Click Add Region and select a region from the dropdown. The dropdown only shows regions that you have not yet configured, preventing duplicates.
Each region rule lets you override:
- Consent model - Opt-in, Opt-out, Notice Only, or Hidden.
- Button visibility - Accept All, Reject All, and Preferences toggles.
- Dismiss behaviour - scroll and timeout auto-dismiss settings.
- Consent duration - how long the consent cookie persists (in days).
- Cookie wall - whether to show a full-page wall requiring consent (Pro feature).
- Do Not Sell link - whether to show the CCPA opt-out link.
- Active toggle - temporarily disable a region rule without deleting it.
Supported Regions
Kukie.io supports 27 geographic regions, grouped into:
- Europe - EU (all member states), individual EU countries (e.g. DE, FR, IT), UK, EEA, Switzerland.
- Americas - US (nationwide), California, Virginia, Colorado, Connecticut, and other US states with privacy laws.
- Asia-Pacific - Australia, Japan, South Korea, India.
- Other - Brazil (LGPD), Canada (PIPEDA), South Africa (POPIA).
How Geo-Detection Works
When a visitor requests your banner configuration, Kukie.io determines their geographic region using HTTP headers. The detection checks the following sources in order:
- CF-IPCountry - set automatically by Cloudflare if your site uses it.
- X-Country-Code - a custom header that can be set by your CDN or reverse proxy.
- GeoIP lookup - a server-side MaxMind GeoLite2 database lookup as a fallback.
The detected region code is matched against your configured region rules. If a specific rule matches, it is used. Otherwise, the default rule applies.
Tip: If your site is behind Cloudflare (including on Kukie.io's own infrastructure), geo-detection is automatic and requires no additional setup. The
CF-IPCountryheader is always available.
Rule Priority
If you create rules for both a broad region (e.g. EU) and a specific country within that region (e.g. Germany), the more specific rule takes priority. This lets you apply stricter or more lenient settings for individual countries within a region.
Testing Region Rules
To test how your banner behaves for different regions, you can use a VPN to simulate a connection from the target region, or ask a colleague in that region to visit your site. The banner's debug mode (?kukie_debug=1) shows which region was detected and which consent model was applied.
Deleting Region Rules
You can delete any region rule except the default. Click the Delete button at the bottom of the rule panel and confirm. Visitors from that region will fall back to the default rule.