> For the complete documentation index, see [llms.txt](https://docs.centousapps.com/i-agree-to-terms/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.centousapps.com/i-agree-to-terms/app-setup/country-blocker.md).

# Country Blocker

## Country Blocker

The **Country Blocker** feature allows you to restrict access to your store based on a visitor’s geographic location. Visitors from selected countries will see an **Access Denied** message and will not be able to access your store.

***

<figure><img src="/files/Ap9PEcUki1r9SYfKg6CV" alt=""><figcaption></figcaption></figure>

## Enable Country Blocker

To activate the feature:

1. Go to **Country Blocker** settings.
2. Enable the **Country Blocker Is Enabled** toggle.

Once enabled, visitors from the selected countries will be blocked from accessing your store.

***

<figure><img src="/files/0t6cN7FeeFpRDlJ7TvZc" alt=""><figcaption></figcaption></figure>

## Geolocation Access Control

This setting allows you to select which countries should be restricted from accessing your store.

#### Select Specific Countries

Choose one or more countries from the list. Visitors from these countries will see a restricted access message.

***

<figure><img src="/files/B4BXGW54Q6yLgQZat2NR" alt=""><figcaption></figcaption></figure>

## Country Blocker Popup Logo

You can display an icon on the restriction page to indicate that access is blocked.

Available options include:

* **None** – No icon displayed
* **Stop Hand Icon**
* **Restriction Icon**
* **Close Icon**
* **Add Image** – Upload a custom logo

**Note:** Maximum upload size is **2 MB**.

***

## Icon Size

Use the **icon size slider** to adjust the size of the logo displayed on the restriction popup.

***

## Layout & Style Settings

The **Layout & Style Settings** allow you to customize the appearance and text displayed on the Country Blocker page. You can modify headings, messages, button labels, spacing, typography, and colors to match your store’s design.

The settings are organized into the following tabs:

* **Content**
* **Spacing**
* **Button**
* **Typography**
* **Color**

***

## Content

The **Content** tab allows you to edit the main text displayed on the blocked access page.

#### Heading

This is the main message shown to visitors when access is restricted.

Example:\
`Access Denied`

***

#### Subheading

Provides additional information explaining why the visitor cannot access the store.

Example:\
`You cannot access our site from your current region.`

***

#### Button

Defines the label of the button displayed on the restriction page.

Example:\
`Return`

Visitors can click this button to leave the page or navigate elsewhere.

***

#### Button URL

Specify the URL where visitors will be redirected when they click the button.

Example:\
`https://google.com`

You can redirect users to another website, homepage, or information page.

<figure><img src="/files/YHnM7O2xjs38UnXIFXk4" alt=""><figcaption></figcaption></figure>

## Preview

The **Preview panel** shows how the blocked page will appear to visitors from restricted countries. It includes the icon, message, and return button.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.centousapps.com/i-agree-to-terms/app-setup/country-blocker.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
