Help

Mercurio: Geolocation

Visitors who land on another country's page get a popup with their country, currency and language. One click switches them through Shopify Markets, and the choice is remembered for their next visit.

Get started

  1. Install the app from the Shopify App Store and open it in your admin.
  2. Switch on the popup: open Selectors and theme and click Open theme editor. The theme editor opens with Geolocation popup from Mercurio: Geolocation switched on under App embeds. Click Save at the top right.
  3. Your look: open Popup, choose a layout and your texts. The preview beside it shows the popup for any visitor country, page and browser language.
  4. Try it: open your store with ?mgeo_country=FR at the end of the address to be a visitor from France. More test links are under Rules; tests are not counted.

The app changes no theme files. Selectors and theme shows whether the popup and the selectors are on in your live theme.

Switch off Shopify's own redirect. If Shopify already sends visitors to their country by itself, the two get in each other's way. Turn it off in Shopify under Settings › Markets › Preferences (or Online Store › Preferences): Automatic redirection. Using Global-e or another redirect app? Switch its redirect off too.

How it always works

These hold on every plan:

  • Shopify tells the app the visitor's country. The app does not look up or store IP addresses, and nothing is stored about the visitor.
  • A switch goes through Shopify Markets: prices, currency, address and checkout follow your markets.
  • Never switched by itself on the first visit. After a choice, later visits go straight to it.
  • Search engines and link previews never see the popup and are never switched, so every country version stays findable.
  • The page, campaign links and discount codes stay as they are: utm_source, discount and the path go along.
  • Layout: Centred, Bar at the bottom, Corner card or Full screen with a picture on the left or right and your store's logo. On phones every layout opens from the bottom.
  • What it offers: a language choice when the country has more than one language, a search in the country list, a link to keep the current country and a close button. Closing keeps the page as it is.
  • Countries in the list: with or without a flag, and the currency as a code, a symbol, both or not at all.
  • Your look: your colours and texts; corners follow your theme's buttons. Your own CSS on paid plans.
  • Texts: left empty, the popup uses our text in the visitor's language. Under Popup › Translations you write your own per language, on Grow also per country. Texts can use {country}, {current_country}, {currency_code}, {currency_symbol} and {language}.

Show the popup can be switched off: then only the selectors and the switches from earlier choices work.

Rules

Under Rules you decide when the popup appears, when a visitor is switched by itself and how long a choice is remembered. Your own rules are part of Starter and Grow; on Free the recommended settings apply.

  • First visit: Visitors from outside your main market (recommended) shows the popup once to everyone outside the countries of your primary market. Only when the page shows another country leaves visitors in the right place alone. Always, as a welcome asks every new visitor once.
  • Return visits: Switch back only in the same country (recommended) or Always switch to the choice, also when the visitor travels.
  • Remember: how many days a choice is kept, and how long the popup stays away after it was closed: a number of days or only for the browser session.
  • Countries you don't sell to: no popup for these visitors, or a text that lets them pick a country you deliver to.
  • Languages: suggest the browser's language or the country's first language, show the popup when the page is in another language than the browser's, and switch to the chosen language by itself on later visits.
  • Order and pages: the popup waits until the cookie banner is closed (Shopify's banner is found by itself, others by a CSS selector), and pages you list never show it, like /blogs/*.

Flag and selector

  • Flag in the header: only the flag of the current country, right before the cart icon. A click opens a small panel with country and language. Many headers take no app blocks, so the app places it for you. Beside the flag you can show nothing, the currency code or the language code.
  • Button in the footer: flag, country, currency and language. A click opens the popup in the layout you chose.
  • Somewhere else? Add the blocks Country flag or Country selector to any section in the theme editor. For flag and button you can also give a place as a CSS selector, like .header__icons.

Countries and other stores

  • Your markets: the countries, currencies and languages come from Shopify Markets, read live. Change them in Shopify; the popup follows at once, no sync needed.
  • Country names: in the page's language, always in English, in the country's own language or both, and your own names for single countries.
  • Fallback country: suggested to visitors from countries you don't sell to.
  • Countries on top (Grow): your main countries first in every list, the rest below in A–Z.
  • Other stores (Grow, up to 10): sell some countries from another store of yours, like your US store on its own domain. Only your own stores and domains, not other sellers or marketplaces. Visitors from there go to the same page there, or to its start page. Campaign parameters go along, and country tells the other store the visitor's country.

Klaviyo and Google Analytics

  • Klaviyo: adds Country (Mercurio) and Language (Mercurio) to profiles Klaviyo already knows. Nobody new is sent. The data goes from the visitor's browser to your Klaviyo account, not to us.
  • Google Analytics 4: the GA4 linker keeps the visit together when the switch goes to another domain.

Insights

How often the popup appears, who switches and where to, for the last 7, 30 or 90 days: popups shown, switched, automatic (return visits sent to their choice), closed, popups and switches per day, the countries visitors go to and the most common switches from one country to another. The counts are anonymous, with no personal data. On Free you also see how many of your monthly redirects are used.

Plans

PlanPriceRedirects per monthHighlights
Free$0500The popup, flag and selector, Shopify Markets with every country, your colours and layout, insights, hidden from search engines
Starter$25 / month or $250 / yearUnlimitedYour rules for first visit, return visits and languages, popup texts in every language, country names, fallback country, your own CSS, Klaviyo (country and language)
Grow$50 / month or $500 / yearUnlimitedEverything in Starter, up to 10 of your other stores and domains, texts per country, countries on top

Every paid plan can be tried free for 14 days. The yearly plans save 17 %. Shopify bills the plan on your Shopify invoice. When you move to a lower plan, nothing is deleted: settings outside the plan rest until you upgrade again.

On Free, the first month over 500 redirects only brings a note on the overview; the popup keeps running. If the next month also reaches 500, the popup rests until that month ends. The flag and the selector keep working.

Questions

Why don't I see the popup in my store?

Check these in order: Geolocation popup is switched on under App embeds in your live theme and saved; Show the popup is on under Popup; you are a visitor the first-visit rule asks (try ?mgeo_country=FR); you haven't closed or chosen in this browser before. The test links under Rules show the popup now or undo earlier choices.

Will search engines still find every country?

Yes. Search engines and link previews never see the popup and are never switched, so every country version of your store stays findable.

Are visitors switched without asking?

Never on the first visit. Only after a visitor chose a country does the store take them there by itself on later visits, by default only when they come from the same country again.

Do my campaign links and discount codes still work?

Yes. The path, campaign parameters like utm_source and discount codes go along with the switch.

Does the app change my theme?

No. The popup is a Shopify app embed, and the flag and footer button are placed by the app. Switching the embed off or uninstalling the app removes everything.

What about privacy?

The visitor's country comes from Shopify; we store no IP address. The popup remembers a choice in cookies in the visitor's browser, set by your store. Insights are anonymous counts. Details are in our privacy policy.

What happens when I uninstall?

The popup, flag and selector disappear and the plan ends. All app data for your store is deleted 48 hours after uninstalling.

Contact

Write to hello@mercuriolabs.app. We usually answer within one working day.