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 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.

Example

If a user visits the Spanish experience from Spain, the popup will appear, allowing the user to confirm their preferences.

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.

Example

When a US user visits the US experience, Orbe will not bother the user since they are in the correct localized experience.

When a French user visits the US experience, the Orbe popup will appear, recommending the French 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.

Example

  • Store they are browsing: United States

  • Country selected on first visit: United Kingdom

  • Current location: Spain

Because the user’s current location (Spain) doesn’t match their saved preference (United Kingdom), Orbe does nothing. The user keeps browsing the US store without interruption.

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.

Example

  • Store they are browsing: United States

  • Country selected on first visit: United Kingdom

  • Current location: Spain

Orbe ignores the user’s current location and redirects them to the UK store every time.

Language selector behavior

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

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.

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.

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.

Example

If you set this to 3 days, a visitor who closes the popup will not see it again for the next 3 days, even if they return multiple times. On day 4, the popup appears again so they can confirm their location.

Hide the popup only for the current browser session

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.

Example

A visitor closes the popup and keeps browsing your store. As long as they keep the same browser session open, the popup stays hidden. If they close their browser at night and return the next morning, the session resets and the popup will appear again immediately.

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.

Example

If you set this to 15 days, Orbe will use the visitor’s selected country and language to automatically guide them to the right store for the next 15 days, without showing the popup again.

On day 16, the popup appears again so the visitor can confirm or update their preferences if their situation has changed.

Last updated

Was this helpful?