> 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-redirect/rule-based-whitelisting.md).

# Whitelist - Redirect

There are two types of Whitelist options available in the app.&#x20;

1. [Rule-Based Whitelisting](#rule-based-whitelisting): configured in specific rules.&#x20;
2. [Global Whitelisting](/geoip-country-redirect/general-settings/global-whitelist-settings.md): works for all rules at once with an option (**Consider Global Settings**) active in each rule, including rule-based configurations.&#x20;

***

## Rule-based Whitelisting

Rule-based whitelisting prevents redirection for certain users for a particular rule.

It has two options to prevent redirection:

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

### A. Consider Global Whitelisting

The **Consider Global setting** is used to apply the configuration of the Global Whitelist setting to the specific rule.

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

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

***

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

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

**Steps to configure:**

1. Go to **Country Redirect** → 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**.

#### *Country Redirect - Whitelist section*

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

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

The app only supports Public IPv4 addresses.&#x20;

The IP address should be added in a comma-separated format with no spaces.
{% endhint %}

***

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

This option prevents redirection for specific 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 redirection 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 redirection will be disabled from all the pages which contain the path (/products).
  {% endhint %}

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

### **1. Exact**

With the Exact type, you can whitelist redirection from specific URLs in your primary store.

For example, to prevent redirection 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/Fx5p5NiW6piKVE8gnhVP" alt=""><figcaption></figcaption></figure>

### **2. Contains**

With the Contains type, you can prevent redirection using a keyword in the URL. If the URL contains that specific keyword, the redirection will not be triggered on that URL.

For example, you want to **exclude URLs from redirection 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 redirection.

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

***
