# Translations {% hint style="info" %} Exclusive feature available in the **Advanced** and **Plus** plans. {% endhint %} You should use a third-party translation app to translate your store, but not the Orbe app embed. Orbe has its own technology to translate its popup because Orbe is designed to **show its geolocation popups** when customers **are in the wrong localized experience**. For example, if a customer is browsing your store in English but their browser is set to Spanish, and you have a Spanish experience available, Orbe will automatically display the message in Spanish.
This ensures that Orbe will guide the customer to **the right country experience** in their **preferred language**. You have the flexibility to customize the popup in multiple languages, ensuring that your users receive the best recommendation experience based on their browser language. ## How does it work? After configuring the popup in multiple languages, if a user's browser language matches one available, that version will be displayed, considering it as the user's preferred language. Here are some examples: * If your store has English, French, and Spanish, and a user's browser is set to Spanish, the popup will be displayed in Spanish, even if they visit from a United Kingdom IP address. * If the browser is in a language not available in your store, the popup will be shown in the default language you set up in the Orbe editor. This tutorial will walk you through the process, explaining how Orbe functions and guiding you on how to activate the multilingual popup. ## Translate your welcome popup {% hint style="info" %} You can customize the popup **in the languages 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. {% endhint %} Translating your Orbe popup is simple and effective. Check out this video tutorial on how to translate your popup: {% embed url="" %} ### **Dynamic Variables** Orbe also allows you to include dynamic variables that adapt to the user's location and preferences: * **{country}**: Shows the customer’s country (e.g., Spain) * **{currency\_code}**: Displays the country’s currency code (e.g., EUR) * **{currency\_symbol}**: Displays the currency symbol (e.g., €) ### **Pre-fill templates**
You can easily use these templates by clicking on "Use a Template." These templates are fully customizable, allowing you to adjust the message as needed to match your brand's voice. Orbe provides pre-set templates for the following languages: * English * French * Spanish * Italian * German * Portuguese * Swedish You'll need to manually input the translation for languages not covered by our templates. ## Customize your welcome popup by country {% hint style="info" %} This feature is available only for **Plus** and **Enterprise** plans. {% endhint %} Orbe allows you to adapt the content of the welcome popup based on the customer’s country. This feature gives you the flexibility to display specific messages, such as: * The **shipping threshold** for their country * Their **local payment method** available at checkout * **Taxes** and **duties** information * Custom messages or offers By doing so, you can welcome your international users, enhance their experience, and **build trust** from the very first interaction.
### How does it work? Once you're on the Plus or Enterprise plan, navigate to the **"Translations"** section. There, you’ll find a new 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. Dynamic variables like `{country}`, `{currency_symbol}`, and `{currency_code}` are available to ensure flexibility. Check out this tutorial to learn how to use it: {% embed url="" %} ## Fallback translation for unsupported countries In cases where a customer visits from a country where you don’t sell, Orbe allows you to fully customize the popup with a fallback translation. This means that, **for unsupported regions**, you can **change all popup texts to notify the customer that you don’t ship to their location** and provide a list of alternative countries where they can shop. You can set a specific fallback message for each available language, ensuring that even users from unsupported regions receive clear guidance. Watch this video to see how the fallback feature works and how to set it up: {% embed url="" %} ## Preview your translations Before saving any changes, you can preview exactly how the popup will look with your translations applied. This lets you verify the copy, formatting, and dynamic variables (like `{country}` or `{currency_symbol}`) before publishing any changes. To use it, make your edits in the Translations editor and click **Preview**. A live preview of the popup will appear showing how it will be displayed to your visitors. {% embed url="" %} --- # Agent Instructions: 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.orbe.app/geolocation-popup/translations.md?ask= ``` 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.