Set up Sitecore IP Geolocation

Current version: 9.0

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.

Set up system requirements

The Sitecore IP Geolocation module is fully compatible with Sitecore Experience Manager (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 through the Sitecore Support portal. The Sitecore IP Geolocation service is free of charge and with unlimited lookups per month.

To activate the Sitecore IP Geolocation service:

  • In the \App_Config\Sitecore\Marketing.Tracking\Sitecore.Analytics.Tracking.config file, set the Analytics.PerformLookup property to true on every CD instance.

Subscribe to the Sitecore IP Geolocation Service

After activating the Sitecore IP Geolocation service, you must go to the Sitecore Support & Self Service portal and sign up for a subscription.

To subscribe to the Sitecore IP Geolocation service:

  1. Go to the Sitecore Support & Self-Service Portal, and click Create Service Requests.

    Note

    The number of widgets that you see in the portal depends on your permission level.

  2. Click IP Geolocation Agreement.

  3. In the IP Geolocation Agreement dialog box, enter your account and contact details.

  4. To confirm your subscription, accept the Sitecore® IP Geolocation Terms of Service.

Now your subscription is complete.

Note

After you have activated your subscription, it can take some time for the system to update the license information. When the system has updated, the Sitecore IP Geolocation service will automatically conduct geolocation lookups.

Configure a firewall

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

To configure a firewall:

  • Add a firewall rule to allow HTTPS protocol for:

    • geoIp-ces.cloud.sitecore.net

    • Discovery-ces.cloud.sitecore.net

Use a proxy server

When requests come from a reverse proxy server to your Sitecore instance that you want to track as the valid IP addresses of a client (not as the IP addresses of a proxy),you must use a proxy server.

To use a proxy server, use the following setting:

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

Do you have some feedback for us?

If you have suggestions for improving this article,