> 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/geomarket-redirect/auto-redirect.md).

# Auto-Redirect

## 1. Enable Auto-Redirect

**Redirect visitors to relevant markets according to their country**

* When enabled, visitors are automatically redirected to the appropriate Shopify Market based on their **IP address**.
* The redirect also applies the **local currency and language** configured for that market.

**Use case:**\
Ideal for stores operating multiple regional markets with different languages or currencies.

## 2. Include or Exclude Countries for Auto-Redirection

You can control which countries should trigger auto-redirection.

#### Options

* **Include**\
  Redirects will apply **only** to the countries listed.
* **Exclude**\
  Redirects will apply to **all countries except** those listed.

#### Country Input Field

* Enter one or more country names.
* **If left empty,** auto-redirect applies to **all countries**.

## 3. Language-Based Redirection

Choose how the visitor's language is determined.

* **Always redirect to the market’s default language:**: Redirects to the market’s default language, regardless of browser settings.
* **Automatically switch the visitor’s language according to the browser’s preferred language**: Redirects based on the browser’s language preference and the visitor's location (for individual markets).
* If no matching Shopify market (locale) exists, redirection will not occur.

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

## **4. Redirect Behavior:**

Define when redirection occurs.

* **Redirect when necessary**: Redirects only if the visitor lands on an incorrect market (language/currency).
* **Force redirect every time**: Always redirects to the correct market, even if the visitor tries to switch markets.
* **Redirect once**: Redirects only on the first visit.

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

### **Filter By URLs**

Apply auto-redirects to specific URLs.

* **Include**: Trigger redirection only on the listed URLs.
* **Exclude**: Do not trigger redirection on the listed URLs.

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

### **Filter by Params:**

Apply auto-redirects based on URL parameters.

* **Include**: Trigger redirection only for the listed parameters.
* **Exclude**: Do not trigger redirection for the listed parameters.

### **Retain Behaviour:**

Retains included or excluded parameter settings in browser cookies for **24 hours**

<figure><img src="/files/0FonqjoJfMpGmYdsS1sU" alt=""><figcaption></figcaption></figure>

**Need Help?**\
For assistance, contact us at **<help@spicegems.com>**.