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)
    US English (US)
    FR French
    DE German
    ES Spanish
    IT Italian
    JP Japanese
    • Home
    • User Guides
    • Locator + Pages

    Implement the Locator & Pages in a Single-page-application (SPA)

    Written by Matthias Staudinger

    Updated at September 2nd, 2025

    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.

    • Getting Started
      API Guides 'Near Me' 360 Product descriptions New here Configuration and Connection Guides
    • Uberall Academy and Learning Resources
      Learning Resources - Best Practices Uberall 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 Directories
    • Connecting Tools
      Connection Troubleshooting API
    • Org Settings
      Users Billing API Keys Webhooks Legal Documentation Product Descriptions
    + More

    Table of Contents

    Introduction Steps to follow Step 1 Step 2 Info Step 3 Step 4 Step 5 Warning Example

    Introduction

    The store-locator works out of the box for server-side-rendered pages, but for pages that are rendered only once on start and then the browser window doesn't get re-rendered on click of a different page, there have to be some manual configurations to make the store-locator work. This is often the case for websites which use popular frameworks like React, Vue.js or Angular. 

    Steps to follow


    Step 1

    Add the initial store-locator script to your html:

    <script src="https://uberall.com/assets/storeFinderWidget-v2.js" type="text/javascript"></script>


    Step 2

    Add the container div to your component inside the SPA:

    <div 
        id="store-finder-widget" 
        data-key="KEY">
        // any other customization options
    </div>


    The store-locator won't start automatically with a SPA, because the initial script can't find the div with the id "store-finder-widget" because this will only be rendered at the execution of javascript.

    Delete

    Info

    See also this article on how to implement the Locator & Pages widget for more details on the general setup.


    Step 3

    When starting the store-locator for the first time and the store-locator div is in the current HTML structure, you need to call

    window.UberallStorefinderStart(); 

    This will trigger the initial script and load the bundle. The store-locator should now show up and work properly.


    Step 4

    When going to a different route inside the SPA, you need to call 

    window.UberallStorefinderUnmount();


    on unmount of the store-locator component. This will make sure all components are correctly unmounted and can be started up properly again if the user comes back to the view.


    Step 5

    When going back to the route where the store-locator component is shown, you need to call

    window.UberallStorefinderRestart();


    in order to trigger the already loaded store-locator bundle. 

    Delete

    Warning

    You need to add some logic to make sure the first time this component is rendered, you start it with window.UberallStorefinderStart() and only the times after that call window.UberallStorefinderRestart()


    Example

    Here is an example repository with a React implementation with this store-locator component carrying most of the logic mentioned in the steps above.

    implement install

    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 2025 – uberall.

    Knowledge Base Software powered by Helpjuice

    Expand