> For the complete documentation index, see [llms.txt](https://help.spicegems.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.spicegems.com/geoip-country-redirect/country-blocker/country-blocker-whitelist-settings.md).

# Whitelist - Blocker

There are two types of Whitelist options available for the Blocker Rule in the app:

1. [**Rule-Based Whitelisting**](#rule-based-whitelisting)**:** Configured within specific rules.
2. [**Global Whitelisting**](/geoip-country-redirect/settings/global-whitelist-settings.md)**:** Applies to all rules at once if the *Consider Global* setting is enabled in the rules.

## Rule-based Whitelisting

Rule-based whitelisting prevents blocking for certain users within a specific rule.\
It offers **two options** to prevent blocking:

1. [**Whitelist IP Setting** ](#b.-whitelist-ip-setting)
2. [**Whitelist URL Setting**](#c.-whitelist-url-setting)

### A. Include Global Whitelisting

The **Include Global Whitelist setting** applies the Global Whitelist configuration to the selected blocker rule.

To use [**Global Whitelisting**](/geoip-country-redirect/settings/global-whitelist-settings.md) configuration **(added IP address or URL)** with rule-based configurations, you can enable **the Include Global Whitelisting option** in a required rul&#x65;**.**

<figure><img src="https://2119731643-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lo5KC5Ta6Fs1-alV4Av%2Fuploads%2Fz2zPIEudWFXPphcxfUY9%2FBlocker_whitelist-1.png?alt=media&amp;token=f044f668-4ef3-4f0e-92b6-c0c524a305f9" alt=""><figcaption></figcaption></figure>

***

### **B. Whitelist IP Setting**

This option allows you to disable blocking completely for specific IP addresses.

**Steps to configure:**

1. Go to **Country Blocker** → click **Edit** on the rule you want to update.
2. Go to the **Whitelist** option.
3. Enter the **IP address** (only Public IPv4 is supported).
4. Click **Save**.

<figure><img src="https://2119731643-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lo5KC5Ta6Fs1-alV4Av%2Fuploads%2FbHlLTjsKXKiAAiSnTR9u%2FBlocker_whitelist-2.png?alt=media&amp;token=f0f7fe93-ddb4-4dd6-9fcd-15a4faf7b6e6" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Note the following points:**&#x20;

* Only IPv4 addresses are supported.
* IP addresses must be entered in a **comma-separated format with no spaces**.
  {% endhint %}

***

### **C. Whitelist URL Setting**

This option prevents blocking for added URLs on your store.

Steps to configure:&#x20;

1. Click + Add URL.
2. Add the URL details.
3. Select the Type (Exact/Contains)
4. Click on save.

{% hint style="info" %} <mark style="color:$primary;">**URL Format:**</mark>&#x20;

1. **Full URL:**&#x20;

* Enter the complete URL (domain required).
* Example: \*\*<https://spice-country-redirect-demo.myshopify.com/pages/contact**&#x20>;
* Used in Type: **Exact**
* Result: The blocker will be disabled from this specific page.

2. **URL Path:**

* Enter only the path of the URL (not the full domain required).
* Example: /products&#x20;
* Used in Type: **Contains**
* Result: The blocker will be disabled from all the pages which contain the path (/products).
  {% endhint %}

<figure><img src="https://2119731643-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lo5KC5Ta6Fs1-alV4Av%2Fuploads%2FGOFqWK7pN0pwSWMKEI7o%2FBlocker_whitelist-3.png?alt=media&amp;token=73536a24-e51b-48aa-b6f6-1e96242369d3" alt=""><figcaption></figcaption></figure>

### **Use cases of URL Whitelisting**

### **1. Exact**

With the Exact type, you can disable the blocker rule from specific URLs in your primary store.

For example, to prevent blocker rule from the '**Contact-us**' page. In that case, you need to add the full URL (**<https://spice-country-redirect-demo.myshopify.com/pages/contact>**) with the **Exact** type in the app.&#x20;

<figure><img src="https://2119731643-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lo5KC5Ta6Fs1-alV4Av%2Fuploads%2FjTWMtPfVKyhUdnbeWfJK%2FBlocker_whitelist-4.png?alt=media&amp;token=3142c06e-eea0-4de1-b14c-de5cf70ace7c" alt=""><figcaption></figcaption></figure>

### **2. Contains**

With the Contains type, you can prevent blocking using a keyword in the URL. If the URL contains that specific keyword, the URL can be accessed.

For example, you want to **exclude URLs from blocking that contain** the keyword “products“. In this case, you need to add the “**/products**” keyword in the app and select the type “**Contains**“ to prevent blocking.

<figure><img src="https://2119731643-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lo5KC5Ta6Fs1-alV4Av%2Fuploads%2FOZywNVbCTynawxaj1IFD%2FBlocker_whitelist-5.png?alt=media&amp;token=f3c5e2d6-657f-40aa-8057-5795fc43d47f" alt=""><figcaption></figcaption></figure>
