Adding geo headers with Cloudflare

It's useful to know which part of a country your visitors are coming from. You might show region specific content, helping users to find information easier.

This post explains how to add location specific headers to your requests using Cloudflare Workers.

Transform Rules

Cloudflare allows you to create transformation rules for modifying HTTP headers. Transformation rules are easy to set up, but adding region specific headers need a Cloudflare Business or Enterprise plan.

Access to geoip fields requires a Cloudflare Business or Enterprise plan

Adding the header with Workers

The other option is to write a Worker, which injects the location headers for us. Let's see how we can do this.

Open your Cloudflare Dashboard and create a new worker. Choose a name, select the "HTTP handler" template and click "Create service".

Creating a new worker in Cloudflare Dashboard

Once we create the worker, we need to change the sample code to inject location headers to the request. Click the "Quick edit" button under the "Resources" tab, to open the code editor.

Edit worker code

Add the following code to your worker:

addEventListener("fetch", event => {

async function handleRequest(request) {
  const requestWithRegion = new Request(request);
  return await fetch(requestWithRegion);

The handleRequest function starts with creating requestWithRegion. We need this, since the request parameter is immutable and we can't add new headers to it. In the next step, we add the x-region header containing the region code from the cf object.

There are many location properties you can use from the cf object. Some examples are postalCode, metroCode, region or regionCode. I couldn't find the documentation about the properties of the cf object. There is however a geolocation example listing all geolocation data fields.

Click "Save and Deploy" in the editor and your worker will be ready to accept requests.

Adding code to the worker

Once the code of the worker is changed and saved we need to set when it's going to be executed. You can set what URLs should trigger the worker under the "Triggers" tab.

Enter the route which should trigger the worker and set the corresponding zone. In the example below I'm using wildcards to have it attached on every URL of

Setting triggers for the new worker

That's it. These are all the steps needed to set up the worker. After this, the requests hitting your server will contain the extra header:

Region header example

Cloudflare makes it easy to add extra functionality on the edge. This is a simple example, but can make the user experience more pleasant.

P.S. I'm ptrlaszlo on twitter, follow me for more stories.