Geoblock Registration

Geoblock Registration 1.2.0

No permission to download
Compatible XF 2.x versions
  1. 2.1
  2. 2.2
Additional requirements
Phar extension for php must be enabled
This XenForo 2.x addon provides Geoblocking capabilities for user registration.

You can set allowed and denied lists for countries based on the IP address a user registers from - and optionally force users from non-approved countries into the moderation queue when registering.

The addon uses the free Maxmind GeoLite2 downloadable IP database to identify the country associated with the IP address of a registering user.

As an example, a typical use-case for this addon might be for an Australian website to allow users from Australia and New Zealand to be approved automatically, while users from, say, Russia, Nigeria and other common sources of spammers are blocked from registering. Users from all other countries can be placed into the moderation queue for manual approved by moderators.

Note that as of 30th Dec 2019, you can no longer directly download the Maxmind GeoLite2 database - see: Significant Changes to Accessing and Using GeoLite2 Databases. Version 1.1.0 of this addon addresses this change with the ability to specify a license key from your Maxmind account which will allow you to download.

GDPR block

A "Reject EU Registrations" option can be enabled to automatically block registrations from any countries within the European Union, which may help minimise risk for sites which are not serving EU members and do not intend to implement full GDPR support. Note that existing registered users will be unaffected by this setting - it only applies at registration.

This option will be over-ridden by Approved and Denied lists, which can be useful for cases such as the UK, where they are technically still part of the EU until Brexit occurs, so by adding "GB" to the Approved list, you can avoid blocking people from the UK while blocking everyone else in Europe.

Of course, users can always use a proxy server to get around these blocks - but at least you've made a concerted effort to block EU members - which is all you can do.

The message a user will receive when their registration is rejected because of the EU block is "Your registration has been rejected because we do not allow people from the European Union to use our site. Please contact the administrator for further information or assistance."


1. Install the addon using the standard installation mechanisms. The addon will create a single database table for caching of IP address lookup data.

2. Be sure to add some approved and denied countries to the configuration options - see below.

3. Download the GeoLite2 database using the "Update Maxmind Database" function, which can be found under the Tools menu in the admin area. The database is updated by Maxmind weekly and will be automatically downloaded every week using a cron task.

You must have the Phar extension enabled on your server for database download and extraction to function.

Configuration options




Database update

The GeoLite2 database is updated automatically once per week using a cron task to download it from Maxmind's servers. To manually update the database, you can use the update tool in the Admin area:


Lookup test

Perform a database lookup and show the country code for the IP address


Configuration tester

Test an ISO code against your configuration options to determine what action would be taken for a user from that country. Optionally simulate a user from the EU to test EU block configuration.


See also
Related resources
This addon replaces the "GeoIP + GDPR Geoblocking" addon which was released for XF 2.0 and has now been deleted. That addon used the Maxmind GeoIP Precision web service (paid) to look up country information, while this addon uses the free downloadable database from Maxmind.

A new commercial addon will be available shortly which uses the Maxmind GeoIP Precision Insights web service to provide highly accurate geolocation and IP address information data - including support for detecting VPNs, Hosting providers and other anonymous IP address services.
First release
Last update


5.00 star(s) 5 ratings

More resources from Sim

Latest updates

  1. v1.2.0 update

    bugfix: don't try to uppercase a null iso_code php 8 compatibility fix: don't set a default...
  2. v1.1.2 update

    No new functionality included in this release - just some code cleanup and unit testing. No need...
  3. v1.1.1 update

    v1.1.0 support for new license key URLs for maxmind downloads - see...

Latest reviews

Upgraded today from 1.1.2 to 1.2.0 directly from the ACP.
Everything went as expected. All of my settings such as license key and country codes were transferred intact. This is a very useful product.
Very functional, and easy to install. Nice job, thank you! This plugin will cure my headache with trolls and spamers.
Awesome. This has proved very useful in preventing spam. Thank you.

Others might find it useful to know that it seems there's a small delay in creating MaxMind licence key, and it being recognised as valid.
Installs cleanly and works as advertised. Installation and usage instructions are clear and concise.

It performs the exact function we were looking for.
This add-on is easy to install and configure. Works as expected and provides some additional info to the Spam trigger log. Thanks!
Top Bottom