> 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. Include Global Whitelisting

The **Include Global Whitelist setting** applies the Global Whitelist configuration to the selected 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 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%2FMymvwh5KjMEF0zuWTfCa%2FCR_whitelist1.png?alt=media&amp;token=1e006560-a28d-4dc7-9709-81e043e3adb9" 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="https://2119731643-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lo5KC5Ta6Fs1-alV4Av%2Fuploads%2Fgat3qf1zHzfDQMkrRLJa%2FCR_whitelist2.png?alt=media&amp;token=8f7ad60c-7756-4e67-8acd-d0029700e868" 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/text 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 '**customization-gallery**' page. In that case, you need to add the full URL (<https://sg-country-redirect.myshopify.com/pages/customization-gallery>) 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%2FGoKLsTLSQzamrsUHt9fU%2FCR_whitelist3.png?alt=media&amp;token=e06815b6-d507-46eb-9f30-0e2f98d6c2d1" 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="https://2119731643-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lo5KC5Ta6Fs1-alV4Av%2Fuploads%2FaVtCYBVjmTKG9gYzkTx3%2FCR_whitelist4.png?alt=media&amp;token=9c7bdd9a-93e7-4864-bbca-ff4112ab9b3a" alt=""><figcaption></figcaption></figure>

***
