Locator Upgrade - Shopify Steps
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 thandata-key - settings your shop's scripts pass to
UberallStorefinderMountorUberallStorefinderRestart, other thanwithoutMap
To find them, look in two places:
-
The store finder's
div, in the page's source: anydata-attribute other thandata-key. -
Your shop's scripts, in the page's source and in your theme's JavaScript files: calls to
UberallStorefinderMountorUberallStorefinderRestart.
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
- Link to the store finder's address, for example from your shop's menu.
- If the store finder was on another page before, remove its snippet from that page.
- 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.