This article is part of the series Customize your banner for each version of your site. Before following the guide below, make sure you have reviewed the overview article Choose the right method to load the correct Axeptio banner.
Geolocation allows you to automatically load the most appropriate configuration based on the visitor's location, determined via their IP address.
This is particularly useful when your site must apply different regulations depending on the country (GDPR, CCPA, Law 25, etc.) and geolocation is a more relevant criterion than language or URL structure.
How does it work?
When geolocation is enabled, Axeptio selects the configuration to load according to the following priority order:
Visitor's country regulation — Axeptio detects the visitor's IP address and identifies the regulation associated with their country (e.g., GDPR for a visitor from Spain). All configurations corresponding to this regulation become candidates.
Browser language — among the candidate configurations, Axeptio selects the one whose language matches the visitor's browser language.
Default configuration (fallback) — if no configuration matches, Axeptio loads the default configuration you have defined.
Axeptio uses the browser language of the visitor, not the site language. For example, a visitor with a Spanish IP and a browser in Spanish will see the GDPR ES configuration, even if they are viewing a site in French.
The default configuration must be published to be active.
Example
Your project contains 5 GDPR configurations (FR, EN, ES, IT, DE). A visitor connects from Spain with a browser in Spanish:
Axeptio detects a Spanish IP and associates the GDPR regulation with it.
All 5 GDPR configurations are candidates.
As the browser language is Spanish, the GDPR ES configuration is loaded.
Enable geolocation
Geolocation is configured from the list of configurations for the product in question, for Brands (Cookie banners) or Publishers (TCF cookie banner).
Go to My banners in the product concerned.
Enter a configuration.
Click on the Geolocated display button at the top right of the page.
In the Geo-location modal, enable the Enable location-based display toggle.
Select a default banner in the Default banner settings section — this configuration will be used if no other matches the visitor's location.
If you want to restrict the banner display to certain countries only, enable the Banner visibility toggle and select the relevant countries.
Click on Save and Publish for the changes to take effect.