.. include:: ../../Includes.txt

.. _functions-geoBlocking:

============
Geo Blocking
============

You can block pages (and page translations) for access from certain countries.

.. note::

   You need to to install the `static info tables <https://extensions.typo3.org/extension/static_info_tables/>`__ extension to use
   the geo blocking feature.

.. _functions-geoBlocking-regions:

Regions
=======

So that you do not have to select individual countries every time you want to block a group of countries, individual countries
may be combined into regions. You can create this groups as a record in the list module of your TYPO3 backend.

.. figure:: ../../Images/region-data-record.png
   :alt: Create a new collection of countries
   :class: with-shadow

   Each region (collection of countries) can contain multiple countries and has a title.

.. _functions-geoBlocking-assignRegions:

Assign Regions
==============

After you have created the regions you need, you can assign these regions to a page (or a page translation). This web page will
then be available in the defined regions only. The access to the page from all other countries will be restricted and a 451 HTTP
status code will be returned, which you can process e.g. via a site
`error handler <https://docs.typo3.org/m/typo3/reference-coreapi/master/en-us/ApiOverview/SiteHandling/ErrorHandling.html>`__.

.. figure:: ../../Images/pagetree-country.png
   :alt: Block page for specified regions
   :class: with-shadow

   Assign regions to pages.

.. tip::

   You can invert the selection. If you do this, the page will be unavailable in the specified regions.

.. _functions-geoBlocking-assignRegions-outlier:

Outlier
-------

You can also assign the value "Apply when no IP matches" to the selection. This case occurs when the IP address cannot be
determined or is not stored in the IP database.