IP Geolocation is ideal for Shopify merchants who:

• Sell internationally.
• Manage multiple countries and languages.
• Want to maintain a consistent global brand experience.
• Run multiple Shopify stores (EU, US, UK, etc.).
• Use Shopify Markets and want smarter geolocation handling.

Whether you're a small business testing new regions or an established brand with global operations, IP Geolocation makes cross-border shopping feel natural and intuitive.

1. Install from Shopify App Store: Visit the Shopify App Store, search for "IP Geolocation," and click Install. You'll be redirected to your Shopify admin to approve permissions.
2. Access the Dashboard: Once installed, open the app from your Shopify admin under Apps > IP Geolocation.

When you first open the app, a progress bar at the top of your dashboard will track three essential tasks:

1. Connect Stores: If you operate multiple Shopify stores, connect them so visitors can switch seamlessly.
   • If you only use one store with Shopify Markets, you can skip this step.
2. Configure Rules: Set up rules to control when and where the popup appears.
3. Add Translations: Create custom popup text in different languages.
   • This is optional. If skipped, the app uses the default text configured in the App Embed settings.

The popup and market selector are configured through Shopify's Theme Editor, not the app dashboard.

1. Navigate to Online Store > Themes.
2. Click Customize on your active theme.
3. Click the App embeds icon (left sidebar).
4. Toggle ON for Geo Redirect Popup and Geo Market Selector .
5. Save your changes.

• Geolocation Lookups: Total times the app has detected a visitor's location. This indicates your total traffic volume processed by the app.

• Successful Redirects: How many times visitors accepted a switch to a different market or store.
• Connected Stores: The number of separate Shopify stores linked (Max: 3).
• Translations Created: Number of custom translation sets active.

The app automatically syncs markets configured in your Shopify settings (Settings > Markets).

• Manual Sync: If a market is missing (e.g., you just added, deleted or updated a market in Shopify), click the Sync button on the dashboard to refresh the list immediately.

• Show to All Visitors: The popup appears for everyone. (Safest option to ensure no one is missed).
• Show to Specific Countries Only: Good for testing new markets before a global rollout.
• Hide from Specific Countries: Use this to exclude your home market where redirects aren't necessary.

• Always Show Popup: Ensures maximum visibility. Every new visitor gets a choice.
• Show Only on Wrong Storefront: The popup only appears if the visitor is in a region that doesn't match the current store.
  • Best Practice: Use "Show Only on Wrong Storefront" to reduce friction. If a French customer lands on the French store, they shouldn't be bothered by a popup.

• Always Redirect to Saved Preference: Automatically redirects returning users to their previously chosen store.
• Redirect Only if Location Matches: Checks if the visitor is still in the same physical location before redirecting. Useful if your customers travel frequently.
  • This option will check the visitor’s location every time they visit your store, which may cause the Geolocation Lookups limit to be reached quickly.

Prevent the popup from appearing on specific pages (e.g., Checkout, Privacy Policy).

• Exact Match: /pages/about (Excludes only this specific page).
• Single-Level Wildcard: /collections/* (Excludes collections and immediate subpages).
• Multi-Level Wildcard: /blogs/** (Excludes blogs and all nested sub-paths).

1. Language Only: Matches based on browser language (e.g., all French speakers see the French message).
2. Country and Language: Matches specific combos (e.g., French speakers in Canada see a specific message vs. French speakers in France).

1. Go to the Translations tab.
2. Click Create.
3. Select the Language (and Country, if applicable).
4. Enter the translated Title, Body, and Button text.
5. Save.

1. Generate ID: Go to Connect Stores on the dashboard. Copy your Connection ID.
2. Share ID: Send this ID to the admin of the other store.
3. Connect: The other admin enters your ID into their "Connect a Store" field.
4. Resolve Conflicts: If both stores claim the same market (e.g., both ship to Canada), the app will ask you to designate the "owner" of that market.

• Content: Customize Title, Subtitle, and Button Text.
• Dynamic Variables: Use placeholders to personalize the message:
  • {country} - e.g., "France"
  • {city} - e.g., "Paris"
  • {currency_code} - e.g., "EUR"
  • {currency_symbol} - e.g., "€"
  • Example: "Hi! You are visiting from {country}. Shop in {currency_code}?"
• Styling: Adjust colors, rounded corners, overlay opacity, and fonts to match your brand.

The selector allows users to manually switch markets (e.g., in the Footer or Header).

• Classic Selector: Embeds directly into a specific HTML element on your page.
  • Requires: CSS Selector (e.g., .header__icons or #footer-menu ).
• Modal Selector: A floating button or link that opens a popup window when clicked.
  • Easier Setup: Does not require finding CSS classes.

Popup Not Appearing

• Check App Embeds: Is Geo Redirect Popup toggled ON in the Theme Editor?
• Check Rules: Did you hide the popup for your own country (making it invisible to you)?
• Browser Cache: If you accepted the popup previously, you are now a "Returning Visitor." Test in Incognito/Private mode.

Markets Not Syncing

• Manual Sync: Click the Sync button on the dashboard.
• Shopify Settings: Ensure the market is active in Shopify Admin > Settings > Markets.

Redirects Not Working

• Browser Blocking: Some strict browser privacy settings may block redirects.
• Store Connection: Verify that the Connection Status is "Active" in the dashboard.