Setting up Sitecore IP Geolocation

Last updated Friday, August 31, 2018 in Sitecore Experience Platform for Developer

The Sitecore IP Geolocation service provides information about the location and owner of an IP address beyond that provided by a reverse DNS lookup. IP Geolocation information includes the country, state, city, and the registered company name of every visitor.

You can use IP Geolocation lookups to create conditional renderings or personalization rules that show different content, based on the visitor's location.

This topic describes:

System requirements for Sitecore

Sitecore IP Geolocation is included in the initial version of Sitecore Experience Platform 8.1 (Sitecore XP) and all later versions by default, and is tested with all subsequent updates. This means you only need to subscribe to the Sitecore IP Geolocation service.

The Sitecore IP Geolocation module is fully compatible with Sitecore Experience Management (CMS-only mode).

Activate the Sitecore IP Geolocation service

To activate the Sitecore IP Geolocation Service on Sitecore XP *, you must subscribe to the Sitecore IP Geolocation service in the App Center. The Sitecore IP Geolocation service is now free of charge and with unlimited lookups per month.


Your IP Geolocation service subscription is connected to your unique Sitecore License ID. This means that if you update your license ID (for example, when you use a new license.xml), you must reactivate your IP Geolocation subscription.

Subscribe to the Sitecore IP Geolocation Service

  1. On the Sitecore Launchpad, click App Center.


  2. In the Sitecore App Center, click Sitecore IP Geolocation Service.


  3. Click Continue to proceed with your sign-up and to see a summary of your subscription.


  4. Click Confirm to view the Terms of Service


  5. Select the I accept the terms and conditions check box and click Continue to complete your subscription.


Now your subscription is complete.



After activating your subscription, it may take some time to update your license information. When this information has updated, the Sitecore IP Geolocation service will automatically carry out geolocation lookups.

Configure a firewall

It is common to set up a firewall between your content management and content delivery servers. To ensure that the Sitecore IP Geolocation service works correctly in every scenario, you must configure your firewall settings to allow requests to the service.

Add a firewall rule to allow HTTPS protocol for:


Using a proxy server

When requests that come from a reverse proxy server to your Sitecore instance should be tracked as the valid IP addresses of a client, and not as the IP addresses of a proxy, use the following setting.

  • In the Sitecore.Analytics.Tracking.config file change the value of the Analytics.ForwardedRequestHttpHeader setting to X-Forwarded-For.

Send feedback about the documentation to