We've been making changes to how we organize and display our docs. Our work isn't done but we'd love your feedback.
Getting started
Basics
Domains & Origins
Performance

Configuration
Basics
Conditions
Dictionaries
Domains & Origins
Request settings
Cache settings
Headers
Responses
Performance
Custom VCL
Image optimization
Video

Security
Access Control Lists
Monitoring and testing
Securing communications
TLS
Web Application Firewall

Integrations
Logging endpoints
Non-Fastly services

Diagnostics
Streaming logs
Debugging techniques
Common errors

Account info
Account management
Billing
User access and control

Reference

    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