IP geolocation variables: Migrating to the new dataset

      Last updated August 02, 2018

    Fastly's IP geolocation variables are now based on a new IP geolocation dataset. Following Fastly's feature retirement policy, we'll continue to support variables that use the older version of the geolocation dataset until all of our customers have had time to migrate their service configurations to the newer version. As you migrate your configurations, keep the following important considerations in mind.

    Namespaces differ between versions

    The old version of the IP geolocation variables exist in the geoip namespace. The new version of these variables exist in the client.geo namespace and the Autonomous System (AS) variables exist in the client.as namespace.

    Results for IPv6 addresses will only be returned for client.geo and client.as namespaces.

    Geolocation data may be different

    The data returned for a given IP address may be different between the dataset versions, especially at the city level. While it's possible to migrate configurations by replacing the older geoip.* namespace with client.geo.*, we recommend you carefully review any business logic that may rely on this data, especially if it's implemented in VCL or if the values are exposed via HTTP headers or real-time streaming logs.

    In particular, understand that:

    Back to Top