# 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:** 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)

{% hint style="info" %}
**Note:** Within a single rule, you can use **either IP or URL whitelisting**, but **not both simultaneously**.
{% endhint %}

### 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**](https://help.spicegems.com/geoip-country-redirect/general-settings/global-whitelist-settings) configuration (IP addresses or URLs) together with rule-based settings, simply enable the *Consider Global Whitelisting* option in that particular rule.

<figure><img src="https://2119731643-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lo5KC5Ta6Fs1-alV4Av%2Fuploads%2Ft2BJPQ98ej62UFsENNTB%2FBW-1.png?alt=media&#x26;token=29fd6dca-b70d-4947-a118-690e123ccde4" 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="https://2119731643-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lo5KC5Ta6Fs1-alV4Av%2Fuploads%2FwniB1rkF1gfVerfZRBE3%2FCB-W1.png?alt=media&#x26;token=53fac8d7-a984-4e1e-9d42-120b23d070f3" 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;

**Add URL Path:**

* Enter only the path of the URL (not the full domain).
* Example: /product/toy-stopper → This applies only to that exact page.

**Choose a required Type:**

* **Exact**: Prevents blocking only if the URL exactly matches the path you entered.
* **Contains**: Prevents blocking if the specific content is found in the URL.
  {% endhint %}

<figure><img src="https://2119731643-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lo5KC5Ta6Fs1-alV4Av%2Fuploads%2FYGPDNU3FS8GtQ3ewKnYw%2FBW-3.png?alt=media&#x26;token=d0428756-97df-4eca-9742-2a0fed52fd93" alt=""><figcaption></figcaption></figure>

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

### **1. Exact**

With the Exact type, you can whitelist (prevent blocking) a complete URL in your primary store.

For example, you want to prevent blocking on the 'Contact-us', 'about-us' or 'blogs'. In that case, you need to add the URL path 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%2FVlK40treev5Mwxw7FnFl%2FBW-4.png?alt=media&#x26;token=89f1c8e7-4123-40a8-a6d8-db9e1db947a6" alt=""><figcaption></figcaption></figure>

### **2. Contain**

With the Contain 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 “**Contain**“ 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%2FA9aADzZmwnM4K8FOMvZs%2FBW-5.png?alt=media&#x26;token=63b57260-6d67-40b9-8f74-ea61070bcdaa" alt=""><figcaption></figcaption></figure>
