> For the complete documentation index, see [llms.txt](https://help.orbe.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.orbe.app/geolocation-popup/translations.md).

# Translations

Welcome every visitor in their language, with the details that matter most for where they are.

{% hint style="warning" %}
This setting is only available on **paid** plan.
{% endhint %}

Orbe's translation engine is built for one job: **matching every visitor to the right country experience, in their browser language**.

Orbe is designed to show its geolocation popup the moment a visitor is in the wrong localized experience, and to guide them to the right one, in the language their browser is actually set to. You can customize that popup in as many languages as you need, so every visitor gets that recommendation in the language they understand best.

<figure><img src="https://1070558711-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9pRSk2pXNrLaA6YXOW5G%2Fuploads%2FpSIIztat6e6vJ8PJN3c3%2FTranslations%20-%20Help%20Center.png?alt=media&amp;token=54e3a286-943b-414c-a390-02fb5a6a6a76" alt=""><figcaption></figcaption></figure>

Take a visitor browsing your English store with a Spanish browser. If you have a Spanish experience live, Orbe notices the mismatch and shows the message in Spanish. No setup per visit, no manual triggers. Just the right language, every time.

## How does it work?

Once your popup speaks every language your store needs, Orbe takes over the decision. It reads the visitor's browser language, matches it against what you've configured, and shows the right version.&#x20;

Here's how that plays out:

* A visitor's browser is set to German, and your store has English, French, and German live. Orbe shows the German popup, even if that visitor is browsing from a United Kingdom IP address.
* A visitor's browser is set to a language your store doesn't have. Orbe falls back to the default language you set in the Orbe editor.

This page walks you through activating the multilingual popup and explains exactly how Orbe decides which language to show.

## Translate your welcome popup

{% hint style="info" %}
You can translate the popup into **any language already configured in your Shopify store**. If a language is missing, it won't appear in Orbe's options, so make sure all required languages are added to your Shopify settings first.
{% endhint %}

Your popup is fully customizable, and adapts to every language you have active in Shopify.&#x20;

<figure><img src="https://1070558711-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9pRSk2pXNrLaA6YXOW5G%2Fuploads%2FsjgdRBsHWk4aq73njkeN%2Ftranslations.png?alt=media&amp;token=cd955392-39e6-4adb-b633-32d3a86b6da1" alt=""><figcaption></figcaption></figure>

Translating it to all of them takes a single click: prepare copy that works for you, or start from one of our templates, personalize it with the information you want to show, and hit *Translate to all your available languages*. That's it, your message is now live in every configured language.

To make it feel even more tailored to each country, use [Variables](#variables). They're a set of fields you can drop into your copy, like currency code, payment methods, delivery time, or return window, so the same message adapts to each market without you rewriting it.&#x20;

You can also customize your default text, the version Orbe shows whenever a visitor's language isn't available in your Shopify store.

The video below walks through the setup:

{% embed url="<https://www.loom.com/share/838fa303796d480e9e95ebbe0e9b1bc5>" %}

### **Variables**

Orbe includes a set of variables that adapt to each visitor's location and preferences, so the same copy feels personal in every market:

**Filled in automatically**\
These adapt automatically based on the visitor's country, no setup required on your end:

* **{country}**: shows the visitor's country (e.g., Spain)
* **{city}**: shows the visitor's city (e.g., Madrid)
* **{currency\_code}**: shows the country's currency code (e.g., EUR)
* **{currency\_symbol}**: shows the country's currency symbol (e.g., €)

**Pre-filled from Shopify Markets**

* **{taxes\_duties\_inc}**: shows “Taxes and duties included” or “Taxes included”. Orbe pre-fills it from your Shopify Markets settings.

**Set by you, per country**\
Configure these for each country that matters to you:

* **{shipping\_threshold}**: shows the minimum order amount for free shipping (e.g., 50)
* **{delivery\_time}**: shows the estimated number of delivery days (e.g., 5)
* **{return\_time}**: shows the number of days in your return window (e.g., 30)
* **{payment}**: shows the visitor's available payment methods (e.g., PayPal and Credit Card)

Managing the variables you set per country is just as simple: click ***Manage***, and you’ll land on the page where you can set the values you want for every country that matters to you.

<figure><img src="https://1070558711-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9pRSk2pXNrLaA6YXOW5G%2Fuploads%2FByRU9PGT9ZkZR6aZ0wAr%2Fimage.png?alt=media&amp;token=22dc3231-c829-4eb4-8438-88af67a931b9" alt="manage-variables"><figcaption></figcaption></figure>

### **Pre-fill templates**

Get started faster with a template. Click ***Use a Template*** to drop in ready-made copy, fully customizable to match your brand's voice.

<figure><img src="https://1070558711-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9pRSk2pXNrLaA6YXOW5G%2Fuploads%2FLO5Dekr2KTyfJmRn3Rii%2Ftemplates.gif?alt=media&amp;token=10b06b8d-dad4-444c-a6f6-2e10b7d1dd8f" alt=""><figcaption></figcaption></figure>

Orbe provides ready-made templates covering **the main languages spoken worldwide**.

If your language isn’t covered, write your own popup copy and hit *Translate to all available languages*. It works the same way for every language you have configured, template or not.

## Adapt your welcome popup by country

{% hint style="warning" %}
This setting is only available on **Plus** and **Enterprise** plans.
{% endhint %}

Orbe allows you to adapt the content of the welcome popup based on the customer’s country, so international visitors see what they need to buy with confidence from their very first visit:

* Whether **taxes and duties** are included
* The **local payment methods** available at checkout
* Your **free shipping threshold** in their currency
* The estimated **delivery time** and your **return window**
* Custom messages or offers for that market

By doing so, you welcome your international visitors with the information that matters to them and **build trust from the very first interaction**.

<figure><img src="https://1070558711-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9pRSk2pXNrLaA6YXOW5G%2Fuploads%2FPhuWdIdiwrAvGSCC02E5%2FExample.png?alt=media&amp;token=018be614-b52b-41c0-a354-ef345011b491" alt=""><figcaption></figcaption></figure>

### How does it work?

Navigate to the *Translations* section and there you’ll find a selector called ***Adaptations***, located next to the *Language* dropdown. This allows you to create a version of the popup that displays **country-specific content** while still respecting the user's browser language.

When international visitors land on your store for the first time, Orbe will display a welcome popup with the customized information you’ve tailored for their location and language. For example:

* You can create unique content for **Canada** in both **Spanish** and **French**. The popup will prioritize the language of the customer's browser but adjust based on the country.
* If there’s no country-specific translation, the default language version will be shown.

Customization is done manually per country, but you can easily use the `Apply to multiple countries` option to manage multiple locations with the same shipping or payment conditions.

Check out this tutorial to learn how to use it:

{% embed url="<https://www.loom.com/share/176edb20bb7f43eaa6727e938f1cf943>" %}

## Fallback text for unsupported countries

If a visitor arrives from a country where you don't sell, Orbe lets you fully customize the popup with a fallback translation. For unsupported regions, you can change all popup text to let the visitor know you don't ship there, and point them to a list of alternative countries where they can shop.

You can set a specific fallback message for each available language, so visitors from unsupported regions always get clear guidance, whatever language they're browsing in.

Watch this video to see how the fallback feature works and how to set it up:

{% embed url="<https://www.loom.com/share/8786dcf5c63c4f8bbb2ed81da2c60cbe>" %}


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.orbe.app/geolocation-popup/translations.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.