# 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.