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

<figure><img src="https://2119731643-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lo5KC5Ta6Fs1-alV4Av%2Fuploads%2FhYZUYeeOcFuZ2bPCOO6v%2FGeoMarket_auto1.png?alt=media&amp;token=8254f8bd-df94-44d1-b715-836d73b88a6b" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://2119731643-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lo5KC5Ta6Fs1-alV4Av%2Fuploads%2F9H3EQmCv5TDjNSJBMpmU%2FGeoMarket_auto2.png?alt=media&amp;token=cb572125-54f9-4874-b600-bc243c89f36f" alt=""><figcaption></figcaption></figure>

## 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="https://2119731643-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lo5KC5Ta6Fs1-alV4Av%2Fuploads%2FzrNcuPfAOpt1bQ6dxkMj%2FGeomarket_autoredirect_1.png?alt=media&amp;token=1341e280-75d2-45d3-94e0-e386739f7796" 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="https://2119731643-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lo5KC5Ta6Fs1-alV4Av%2Fuploads%2FO0Pf7n5TvQ7XsErf3wfW%2FGeomarket_autoredirect_2.png?alt=media&amp;token=0ebdafd4-cef2-451a-b542-68ab9c5ae396" 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="https://2119731643-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lo5KC5Ta6Fs1-alV4Av%2Fuploads%2FwCvzBjYF0ATA0RjWsp3D%2FGeomarket_autoredirect_3.png?alt=media&amp;token=d2d78c8f-26ed-4ada-820d-0772c8eb2b38" 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:**

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

<figure><img src="https://2119731643-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lo5KC5Ta6Fs1-alV4Av%2Fuploads%2FGay0NUguDsj5cNAAaLd6%2FGeomarket_autoredirect_4.png?alt=media&amp;token=4840089a-1b49-4bc3-a1b6-b522042a49cf" alt=""><figcaption></figcaption></figure>

#### Click the Save button

<figure><img src="https://2119731643-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lo5KC5Ta6Fs1-alV4Av%2Fuploads%2FMwXioPaJW66uQqeajBYG%2FGeomarket_autoredirect_5.png?alt=media&amp;token=326a858a-94ff-47c3-b115-5a9778d0dd27" alt=""><figcaption></figcaption></figure>

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