# 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/general-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. Consider Global Whitelisting

The *Consider Global* setting allows you to apply the configuration from the Global Whitelist to a specific rule.

If you want to use the [**Global Whitelisting**](/geoip-country-redirect/general-settings/global-whitelist-settings.md) configuration (IP addresses or URLs) together with rule-based settings, simply enable the *Consider Global Whitelisting* option in that particular rule.

<figure><img src="/files/i2zOC9Hr82nqv1Tb54ac" 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. Select the **Whitelist** option.
3. Enter the **IP address** (only Public IPv4 is supported).
4. Click **Save**.

<figure><img src="/files/ezxNhaXJGLwOC8tdvA5f" 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 new Whitelist Rule.
2. Enter the URL details.
3. Click Add to 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="/files/OkQJxDEHd6t7mCciasYj" 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="/files/ivIVY7ucxS0S4hHbaDST" 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="/files/hI13DAKZcSvobJJHb0sO" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: 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://help.spicegems.com/geoip-country-redirect/country-blocker/country-blocker-whitelist-settings.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.
