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
Results for IPv6 addresses will only be returned for
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:
The IP geolocation datasets are sourced from different vendors, each with different conventions for textual values. For example,
client.geo.country_namein the new dataset exist as lowercase ASCII values whereas the values returned for the same fields in older dataset are mixed case.