Geolocation preferences
In any Orbe paid plan, you can configure advanced geolocation behaviors beyond the default settings. This tutorial explains the available geolocation options, allowing each brand to tailor them to their specific needs.
When a customer visits for the first time
This setting is only available on paid plans.
This setting enables you to customize Orbe's behavior when a customer visits your store for the first time.

Show always on the first visit regardless of the user's location
This is the default option. It functions as a welcome popup that appears to all customers on their initial visit, prompting them to select their preferred experience.
This option is highly recommended for customers using the Klaviyo integration, as it enables Orbe to save country and language preferences and send them to Klaviyo for personalized email marketing campaigns.
Show only when the user is in the incorrect experience
This option ensures that the geolocation popup is displayed only when the user is in the wrong shopping experience. When an international user visits an incorrect shopping experience, Orbe will recommend redirecting them to their localized experience.
We recommend using this option if you want to show the welcome popup only for your international customers.
When a customer comes back
This setting allows you to configure Orbe's behavior on the second and subsequent visits of a customer when they are in the incorrect experience.

Redirect only if the current country and preference match
This option (enabled by default) only redirects users when their current location matches the country they previously selected.
If the user is now in a different country, Orbe won’t force a redirect or show the popup again.
Always redirect based on country preference
With this option, Orbe always redirects users to the country they previously selected, no matter where they are located.
Once a user chooses a country, Orbe treats that choice as the source of truth.
Language selector behavior
This setting is only available on paid plans.
This setting allows you to configure how you want a default language to be suggested in the language selector.

Defaultly suggest the user's browser language
This is the default and recommended option, as users typically set their browsers to their preferred language or a language they are comfortable with. Therefore, if the language of their browser is available, it is advisable to suggest that language. Otherwise, the default language configured in Shopify Markets for the respective country will be recommended.
Defaultly suggest the language configured for each market in the settings of Shopify Markets
With this option, Orbe will suggest the default language you’ve set for each market in Shopify Markets. That means visitors will automatically see the language you’ve defined for the market they’re browsing (even if it doesn’t match their browser’s language).
Language Settings
This setting is only available on paid plans.
Sometimes users reach the correct shopping experience but still see the store in a language that doesn’t match their preferences. This often happens in places like Canada, where different regions use English or French, or when users are living abroad, traveling, or browsing from a temporary location. In these situations, customers may receive the right prices, products, and currency for their location, yet the store may not appear in their preferred language, even when that language is available.
Orbe allows you to configure how language should be suggested in these situations, with multiple behavior options that can work together.

Show Orbe if the user is in the correct experience but not using their browser language
This option triggers the popup when a user is in the correct country, experiencing accurate pricing, product availability, and currency settings. If they are not browsing the store in their preferred language based on their browser settings, the system will recommend switching to their preferred language.
Automatically redirect if they're in the right store for their country but browsing in a different language than their preferred one
This option is particularly beneficial when the store's 'Language Settings' are configured to show Orbe if the user is in the correct experience but not using their browser language (the previous setting). It acts as a complementary feature.
For instance, if a brand's primary language for the United Kingdom is English and Spanish is also available, a user choosing the Spanish market as their preference will consistently be redirected to the Spanish experience. Not selecting this option would result in the user visiting the store in English on subsequent visits, even if Spanish is their preferred language.
Please bear in mind that activating 'Automatically redirect if they're in the right store for their country but browsing in a different language than their preferred one' and using your own language selectors (not ours) requires syncing your language selector with Orbe. This synchronization is crucial to allow us to refresh the cookies when users actively change their language preferences. Failure to perform this synchronization could result in your language selector ceasing to function properly. Consequently, users may encounter difficulties in changing their language preferences seamlessly.
Preferences duration
Preferences duration lets you decide how long Orbe should remember a visitor’s choice before showing the geolocation popup again.
This gives you full control over how often visitors are asked to confirm their country or language again. It’s a simple way to ensure the popup appears when it makes sense, and stays out of the way when it doesn’t.
This setting is available on Orbe Plus and Enterprise plans.

After visitor closes popup
Use this option to decide how long the popup stays hidden when a visitor closes it without selecting anything.
You can choose a number of days (minimum: 1, default: 7). During that time, the popup won’t appear again.

Hide the popup only for the current browser session
Recommended for most stores. We recommend this option to guarantee the best overall geolocation experience.
With this option, the popup stays hidden only while the current browser session is active.
Once the visitor closes their browser, the session resets and the popup will appear again on their next visit. It’s an easy way to hide the popup temporarily without choosing a fixed number of days.
After visitor selects country and language
Adjust this setting to control how long Orbe keeps a visitor’s confirmed country and language before asking again. It’s useful when you want to double-check that the shopper is still in the right store and their context hasn’t changed.

During this time, Orbe uses those preferences to automatically guide visitors to the right storefront without showing the popup again.
By default, Orbe remembers the selection for 60 days, but you can shorten this period if you want to reconfirm preferences more often and give visitors the chance to choose again.
Last updated
Was this helpful?