Updating Legacy Installations

If your store locator was installed before 2025, you may be running a legacy version of our script. The latest version includes improved accessibility, better performance, and ongoing support. Legacy versions are no longer maintained and will not receive updates or bug fixes.

How to Tell If You Need to Upgrade#

Check the script tag on the page where your locator is installed. If the src URL contains main-stable, you are on the legacy version and should upgrade.

Legacy script (upgrade needed):

<script defer="defer" src="//cdn.storelocators.com/locator/js/main-stable.js"></script>
<link href="//cdn.storelocators.com/locator/css/main-stable.css" rel="stylesheet"></link>

Current script (no action needed):

<script defer="defer" src="//cdn.storelocators.com/locator/js/locator-stable.js"></script>
<link href="//cdn.storelocators.com/locator/css/locator-stable.css" rel="stylesheet"></link>

Shopify Merchants#

Using the script#

If you are on Shopify but installed the locator manually before the app was available, we recommend switching to the Shopify App rather than updating the script. The app gives you:

• Automatic updates: Always on the latest version with no manual code changes

• More features: Access to the full Shopify Theme Editor integration, retailer-exclusive landing pages, wholesale self-submission, and more

• Easier customization: Adjust styles and settings visually from the Theme Editor instead of editing code

To switch, install the StoreLocators Shopify App, follow the in-app installation instructions, and remove the old script tag from your page. Your existing account and locations carry over; no data migration needed.

If you need help making the switch, reach out to Anthony, our Customer Success Manager, (anthony@storelocators.com).

Using the Shopify App#

If you installed the locator through the StoreLocators Shopify App, this does not affect you. The Shopify App always delivers the latest version of the locator automatically — no action is required on your end.

This is one of the advantages of using the Shopify App: updates, bug fixes, and new features are applied automatically without any manual changes to your site.

Headless / Script Installations#

Step 1: Update the Script and CSS URLs#

Replace the legacy URLs with the current ones. Change only the file names — the rest of the tag stays the same.

Before:

<script defer="defer" src="//cdn.storelocators.com/locator/js/main-stable.js"></script>
<link href="//cdn.storelocators.com/locator/css/main-stable.css" rel="stylesheet"></link>

After:

<script defer="defer" src="//cdn.storelocators.com/locator/js/locator-stable.js"></script>
<link href="//cdn.storelocators.com/locator/css/locator-stable.css" rel="stylesheet"></link>

Step 2: Keep Your Existing Configuration#

Your window.storeLocatorsConfig object — including your customerId, style, and copy settings — does not need to change. The latest version is fully compatible with your existing configuration.

// No changes needed here — your config carries over as-is
window.storeLocatorsConfig = {
  customerId: "YOUR_CUSTOMER_ID_HERE",
  style: {
    contrastColor: "#1a73e8",
    background: "#ffffff",
  },
  copy: {
    getDirections: "Find Us",
  }
}

Step 3: Verify#

After updating the script URLs, load your store locator page and confirm:

• The map loads and displays your locations

• Search works as expected

• Your style and copy customizations are intact

That's it. The upgrade is a two-line URL change.

What's Improved in the Latest Version#

• Accessibility: Improved keyboard navigation and screen reader support

• Performance: Faster load times and smoother interactions

• Ongoing support: The latest version receives regular updates, bug fixes, and new features

Need Help?#