> 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/popup.md).

# Popup

This guide will help you configure the **geolocation popup** in the app to enhance user experience by showing relevant language, currency, or country options to your visitors.

### 1. Enable Geolocation Popup

* Check the "Geolocation popup visibility" box to activate the popup.
* This popup will allow visitors to select their local language and currency.
* To customise the popup – [click here](/geoip-country-redirect/geomarket-redirect/geolocation-popup-editor.md)

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

### &#x20;2. Country-Based Display

You can include or exclude specific countries for showing the popup.

* Include – Show the popup only for the selected countries.
* Exclude – Prevent the popup from showing in the selected countries.
* Enter Country Name in the provided field.

Note: If this field is left empty, the popup will display for all countries.

<figure><img src="/files/2Kb8mvAOWaW63kXsXpVi" alt=""><figcaption></figcaption></figure>

### **3. Display Behavior**

Choose how and when the popup appears to visitors:

<table><thead><tr><th>Option</th><th valign="top">Description</th></tr></thead><tbody><tr><td><strong>Display when necessary</strong> <em>(Recommended)</em></td><td valign="top">Shows the popup whenever a visitor is on the wrong language, currency, or country.</td></tr><tr><td><strong>Remember choice</strong></td><td valign="top">Shows the popup only once and saves the visitor's choice for future visits. In this case, the app will not display the popup again after the first selection for 30 days.</td></tr><tr><td><strong>Display everyone</strong></td><td valign="top">Displays the popup for every new visitor, regardless of settings.</td></tr><tr><td><strong>Display once</strong></td><td valign="top">Shows the popup only once to each visitor.</td></tr></tbody></table>

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

### **4. Filter by URLs**

Control where the popup appears based on specific URLs:

* **Include** – Show popup only on matching URLs.
* **Exclude** – Hide popup on matching URLs.
* Click **"+ Add path/URL"** to enter the URL paths where the popup should be included or excluded.
* The added URLs will be listed below for editing or deletion.

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

**Quick Video:**

{% embed url="<https://vimeo.com/1059267362>" %}


---

# 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/popup.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.