Contact Us

If you still have questions or prefer to get help directly from an agent, please submit a request.
We’ll get back to you as soon as possible.

Please fill out the contact form below and we will reply as soon as possible.

    Sign In
    • Home
    • User Guides
    • Locator + Pages

    Locator Upgrade - Shopify Steps

    Contact Us

    If you still have questions or prefer to get help directly from an agent, please submit a request.
    We’ll get back to you as soon as possible.

    Please fill out the contact form below and we will reply as soon as possible.

    English (US)
    FR French
    IT Italian
    JP Japanese
    DE German
    US English (US)
    ES Spanish
    • Getting Started
      New here Configuration and Connection Guides
    • Academy and Learning Resources
      Learning Resources - Best Practices Academy
    • User Guides
      AI What's New Platform Status and General FAQs Homepage The Dashboard Location Hub Review Management Messages Social Locator + Pages Analytics Directories Mobile App 'Near Me' 360
    • Connecting Tools
      Connection Troubleshooting API
    • Org Settings
      Users Billing API Keys Webhooks
    + More

    Search engines and AI assistants often cannot see your store finder. When they visit the page, your stores are not on it yet: they only appear later, on the visitor's screen. So your stores can be missing from search results and from the answers AI assistants give.

    After these steps, your shop has store finder pages that arrive with your stores already on them, with names, addresses and opening hours. Search engines and AI assistants can find each of your stores and show it. Your visitors see the store finder inside your shop's theme, with your header and footer.

    It works for a store finder already on your shop and for a new one. It works through the Uberall Store Finder app from the Shopify App Store, and takes five steps.

    What you need

    A Shopify shop, and a staff account that can install apps

    Your locator key, from Uberall. If the store finder is already on your shop, it is the data-key of its snippet:

    • <div id="store-finder-widget" data-key="YOUR_LOCATOR_KEY"></div>

    Your render token, from Uberall

    If the store finder is already on your shop

    After these steps, your store finder pages use only the settings saved at Uberall. What is set on the page itself no longer applies there:

    • attributes on the store finder's div, other than data-key
    • settings your shop's scripts pass to UberallStorefinderMount or UberallStorefinderRestart, other than withoutMap

    To find them, look in two places:

    • The store finder's div, in the page's source: any data- attribute other than data-key.
    • Your shop's scripts, in the page's source and in your theme's JavaScript files: calls to UberallStorefinderMount or UberallStorefinderRestart.

    If you find any of these settings, set the same options for your store finder in the store finder builder in Uberall before you start. Until then, leave the page as it is: the store finder keeps working as it does today.

    Step 1: Install the app

    Open the app in the Shopify App Store while you are logged in to your Shopify admin, and click Install. The app is unlisted: you find it through this link, not by searching the App Store.

    Step 2: Connect your store finder

    After the install, the app opens in your Shopify admin. Later, you find it under Apps, Uberall Store Finder.

    Enter your locator key under Store finder key and your render token under Render token, and confirm. The app checks both with Uberall and shows the connected store finder.

    Your store finder is now at /a/store-locator on your shop. You add no snippet: the app puts the store finder on its page itself.

    A shop has one store finder at a time. To connect another, enter its key and render token in the same way: it replaces the connected one.

    Step 3: Choose the address, if you want another

    To use another address, go to Settings, Apps in your Shopify admin, and open the Uberall Store Finder app. In the App Proxy URL section, click Customize URL. The address starts with /a/, /apps/, /community/ or /tools/, followed by a name of your choice. The change takes effect immediately.

    Each store gets its own address under the store finder's, such as /a/store-locator/l/berlin/.... Every address under it belongs to the store finder.

    Choose the address before you link to it. If you change it later, every address under the old one stops working, including those search engines already show: Shopify does not redirect them.

    Step 4: Link to the store finder

    1. Link to the store finder's address, for example from your shop's menu.
    2. If the store finder was on another page before, remove its snippet from that page.
    3. Redirect that page's address to the store finder's: in your Shopify admin, go to Online Store, Navigation, URL Redirects.

    Step 5: Check

    Open your store finder in the browser, right click, and choose View page source. Search the source for __ubSfSsr. If you find it, it works.

    Then open one of your stores and copy its address into a new tab. The store's page should open, with the store's name in the page title.

    What changes on your store finder pages

    Uberall sends the title, the description and the canonical link for each page. Themes that use Shopify's standard page variables for these, such as Dawn, put them in the page's head in place of their own. A theme that builds its own canonical link ends up with two: ask whoever maintains your theme to use Shopify's.

    Where your store finder has no title or description set up at Uberall, your theme keeps its own. The Open Graph tags, which decide how a link looks when it is shared, stay your theme's.

    The structured data (application/ld+json) for each store comes with the store finder's content. Your theme's header, footer and styles stay as they are.

    If it does not work

    What you see What to do
    The store finder's address shows a "Page not found" from your theme Check the address in step 3. The app may not be installed.
    The page says the store finder is not set up Open the app and connect your store finder, as in step 2.
    The page shows your theme's header and footer, with nothing between them Contact Uberall, with your shop's .myshopify.com address.
    The store finder appears, but __ubSfSsr is not in the source Reload once. If it is still not there, contact Uberall.
    The store finder's text is very small Your theme makes text smaller than most sites do. In the store finder builder in Uberall, raise the base font size, such as from 0.875rem to 1.375rem.
    The page title is still your theme's Set a title for your store finder at Uberall, or see "What changes on your store finder pages".
    The canonical link points to your .myshopify.com address Open the app once in your Shopify admin, then reload the page.
    An old link with #! in it opens the store finder's main page The store's page is at the same address without #!.

    When Uberall cannot be reached

    Your whole store finder page comes from Uberall, through the app. So:

    • If Uberall cannot be reached or takes too long, Shopify shows its own error page, without the store finder.
    • If Uberall is reached but cannot prepare your stores for the page, the page loads without them, and the store finder appears on the visitor's screen as usual.

    When changes show

    A change at Uberall, to your stores or to your store finder's settings, takes a few minutes to show on these pages.

    locator shopify

    Was this article helpful?

    Yes
    No
    Give feedback about this article

    Related Articles

    • FAQ about Self Serve Locator & Pages
    • What is embedded Locator + Pages (Self Serve)?
    • Customizations of Locator + Pages via CSS
    • Locator and Pages attributes
    • Filters for Locator & Pages
     

    Copyright 2026 – uberall.

    Expand