GeoIP Headers

When smoxy forwards requests to your origin server, it automatically adds HTTP headers containing geolocation and network metadata based on the client's IP address. You can use these headers to personalize content, switch languages, enforce regional compliance, or build analytics — all without additional lookups in your backend.


Available Headers

Header
Description
Example

s-country

ISO 3166-1 alpha-2 country code

DE, US

s-city

Approximate city

Berlin

s-subdivisions

ISO 3166-2 region/subdivision code

DE-BY

s-latitude

Approximate latitude

52.5200

s-longitude

Approximate longitude

13.4050

s-iseu

Whether the client is in the EU (1 = yes, 0 = no)

1

s-asn

Autonomous System Number of the client's network

13335

s-asorg

Organization name for the ASN

Cloudflare, Inc.

All headers are added automatically to every request — no configuration needed.


Use Cases

Language switching: Use s-country to serve content in the visitor's language or redirect to a localized storefront.

Regional compliance: Use s-iseu to apply GDPR-specific cookie consent banners only for EU visitors.

Geo-targeted content: Use s-country or s-subdivisions to show region-specific pricing, promotions, or shipping options.

Analytics: Log s-country and s-city to understand where your traffic comes from without relying on client-side analytics.

Access control: Combine GeoIP headers with Access Rules or Conditional Rules to restrict or modify behavior by region.

Last updated

Was this helpful?