Content
Control every piece of text and information your customers see, from the popup title to the country, language, and currency they’re shown.
This section lets you tailor the message, behavior, and logic of the popup to ensure it feels relevant, helpful, and aligned with your brand’s voice.
Close button
Enabling this option allows customers to manually close the geolocation popup. If they do, they’ll stay in the shopping experience they initially landed in, and no redirection will occur.
If the popup is closed without selecting a country or market, Orbe will save that decision for 7 days, so the popup won’t show again during that time.

Recommended country flag
Enable this option to show the flag of the customer’s current location in the popup, a small detail that adds a more localized and familiar touch.
For example, a visitor from Spain will see the Spanish flag displayed next to the country name.
You can choose the shape that best fits your design: rounded, square, or circular.

Market currency
This setting controls how currency details appear in the country selector. By default, only the country name is shown, but you can choose to include currency information to make things clearer for your customers.
You can display:
the
{currency_code}
(e.g. United States (USD))the
{currency_symbol}
(e.g. United States ($))or both (e.g. United States (USD $))
You can also combine this with the country flag for a more informative and localized display.

Languages
If your store supports multiple languages, we recommend enabling the language selector. This allows customers to easily switch to their preferred language directly from the popup, improving clarity and reducing friction.
Want to make the most of this feature? Check out our Language Selector tutorial for best practices.

Country search
Make it easier for users to find their country by letting them search as they type. This is especially helpful if you sell in many markets. It saves time and improves the overall experience.

Title, text, helper text, and button text
You can fully customize the title, body text, helper text, and button label shown in the popup. This gives you the flexibility to reflect your brand’s tone of voice or communicate any important details before customers are redirected to the correct shopping experience.

Fallback text
This text will appear in place of the popup title for customers located in countries where your store doesn’t offer shipping. It’s a simple way to set clear expectations and avoid confusion when no shopping experience is available for a given region.
You can utilize the dynamic variables provided to personalize the message for each country:
{country}
: displays the customer's country. Example: Spain{currency_code}
: displays the country's currency code. Example: EUR{currency_symbol}
: displays the country's currency symbol. Example: €
For instance, if your customer is in Spain and you want the title to read "We ship to Spain", you can achieve that using this variable.

Background image
You can add a custom image to your popup to make it more visually engaging. Choose whether the image appears on the left or right side, depending on your layout preferences.
To keep the design clean, we recommend keeping the helper text under 200 characters when using an image.
Recommended sizes:
desktop: 408 × 680 px
mobile: 342 × 363 px

Last updated
Was this helpful?