> 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>**.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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