What is a Geofeed? How to Set Up One?

What is a Geofeed? How to Set Up One?

Basically, a geofeed is a list of IP address ranges associated with geolocation information. The principle was authored by Google in July 2013. Starting August 2020, it is officially published as a standard under RFC 8805 with the name A Format for Self-Published IP Geolocation Feeds.

Geofeeds are used to correct data errors that result from altered prefixes or other variables that affect geolocation. Network operators can publish a mapping of IP address ranges to simplified geolocation information, informally termed a geolocation feed or geofeed. Interested parties (e.g. geolocation providers but not only) can regularly poll and parse these feeds to update or merge data with other geolocation data sources and procedures with very little hassle. At Ipregistry, we check and merge geofeeds daily.

To summarize, the main purpose of geofeeds is to enable different companies to share geolocation data changes using a common and simple format. Benefits are numerous as outlined hereafter.

  • More efficient communication: IP databases often take time to update due to communication breakdowns. Geofeeds clean up what can be a time-consuming process, saving time for your team in the long run.

  • Faster updates: The reality is that updates take time. Using geolocation feeds ISPs, companies, and more generally network operators save time that can be invested elsewhere. Besides, geofeeds also allow geolocation providers such as Ipregistry to pinpoint problems before it ever becomes an issue for customers.

  • Efficient data processing: Data processing is another factor that can impact how quickly IP addresses are updated. Since geofeeds use a standardized format that's easily processed, we can accurately correct any geolocation inconsistencies and automate the process.

  • Better customer satisfaction: IP address errors can have a negative effect on buyers. However, with a geofeed, Ipregistry updates IP address discrepancies long before they ever affect customers.

Are you wondering how to set up a geofeed? Here after are some explanations to create one.

How to set up a geofeed?

To provide above the market accuracy, Ipregistry makes use of a myriad of curated sources (public and private) that are combined using powerful algorithms. Geofeeds is one of these sources.

As an IP data provider leader, ISPs often benefit from sharing feeds with us. If you're an ISP or simply a company that sees the value a geofeed can provide for your customer experiences in the long run, here are steps to take.

1. What should be in your feed?

A geofeed is a Comma-Separated Values (CSV) file where each line depicts a geolocation correction for a given IP range/subnet. The only official requirement for a geofeed is to specify an IP range/subnet. However, the more information within a feed, the better outcome you can expect.

Each line of a geofeed allows including the following values:

  • IP prefix/subnet: an IPv4 or IPv6 range in Classless Inter-Domain Routing (CIDR) format (e.g.
  • Country (optional): a 2-letter ISO country code conforming to ISO 3166-1.
  • Region (optional): a region code conforming to ISO 3166-2. For example, US-TX is the ISO 3166-2 code for Texas in the United States.
  • City (optional): free UTF-8 text excluding the comma character. Ideally, the English name using title case.
  • Postal code (optional): free UTF-8 text excluding the comma character.

Below is a geofeed example with a few entries:

# prefix,country_code,region_code,city,postal,US,US-NJ,Princeton,08540,NL,NL-ZH,Rotterdam,,MA,MA-07,Marrakech,

The first line is a comment. Any comment must start with a # character. The second line is a normal entry. It means that subnet is in use in the postal area 08549 of Princeton, New Jersey in the United States. Following entries specify a location without a postal code.

The last line is an entry with no geolocation information. It is used for privacy enforcement. We suggest always including at least the country code where your IP range/subnet is in use.

2. Where to host a feed?

Geofeeds aim to be hosted for automatic retrieval. The best is to host it under your own domain and make the URL accessible publicly through HTTPS without authentication. This way, any IP geolocation provider can periodically poll your URL for changes you made.

If you don't have anywhere to host one geofeed, here are some options:

  • Create a public Github repository, and add for instance a geofeed.csv file inside. The advantage of using Github is that your file is versioned. This allows you to track changes you publish over time. Besides, since your repository is public, all files are remotely accessible through HTTPs. You can even set up a custom domain.
  • Share a geofeed content via Google Sheets. Make sure to update the share options to make the document accessible to anyone. A manner to verify permissions is to open your URL in an incognito browser. If authentication is required, then you need to edit the share options.

Once you are ready, share the HTTPS URL with us, and we will regularly fetch it and parse data for inclusion in our datasets and databases.

Please note that data flows through different pipelines and not all data is guaranteed for inclusion: some security checks are performed and may exclude your content in case of invalid content or unauthorized IP range/subnet corrections.

3. How often should geofeed data be updated?

Ideally, a geofeed should be updated as soon as geolocation data is updated on your side. For this reason, it is important that geofeed URLs you share are maintained, and your that your team members know about such files. Geofeeds help IP geolocation providers batch-process data, saving you and your customers time and frustration in the long run.

With access to your geolocation updates, our data experts can seamlessly adjust the digital world around your customers so they can access the content and services they need. In the end, you look like the hero to your buyers simply by setting up an automatic geofeed.

Geofeeds help your customers

Not sure how IP geolocation data and geofeed may impact your users and your business? IP geolocation is used in a lot of situations that have real-life impacts: load balancing, country-based redirection, price localization, and many more.

Imagine a user located in France detected as being in a border country such as Italy where shipping options are restricted to that country. As a result, such an inconsistency prevents customers to complete checkout, and directly impacts your business.

A geofeed could prevent this problem before it ever happened. More generally, geofeeds can also help stop other issues for customers. Since IP data has so many real-life applications, the scenarios are endless. For instance, inaccurate IP address information can affect users' experiences on websites. Everything from language to the kind of forms they see can be improved by geolocation data.

For companies using this data to personalize marketing content or purchasing recommendations, it can make the difference between more conversions or not. All this to say, geofeeds help clean up IP address discrepancies so that customers receive the most seamless experience possible.

Have questions or concerns about setting up a geofeed? Our team of experts is ready to help!

Get started with 100,000 free lookups: sign up