Add a store locator to Joomla

What you get

A location map with list, search and filters on your Joomla website. You manage locations in My Store Locator.

Before you start

• A My Store Locator account (sign up free)
• A published map (status "Live")
• For the way without our module, the embed code from the Embed Studio in the app
• A Joomla administrator account (Joomla 4 or 5; for our module Joomla 4.4 or 5)

Install the module

1. Download the zip file above.
2. In the backend, open System → Install → Extensions. On the Upload Package File tab, drop the file into the field or click Or browse for file. Joomla confirms "Installation of the module was successful."

Connect to My Store Locator

1. Open Content → Site Modules, click New and choose the module type My Store Locator.
2. Paste the token into the Map token field (the module confirms "Map token recognised"). The embed code or the map link work too. Or click Connect with My Store Locator, log in and pick your map. The button needs a site running on HTTPS.
3. Enter a Title, choose a Position (for example main-top in Cassiopeia) and keep the Status at Published. On the Menu Assignment tab, choose Only on the pages selected, tick the page and click Save & Close.

Two-click consent is on by default.

Updates

The Joomla module announces new versions itself: Joomla lists them under System → Update → Extensions, and you install them there with one click. The Joomla Extensions Directory listing has been submitted and is being reviewed.

Without our module: as a Custom module

1. In Embed Studio, copy the code from the iframe tab.
2. In the Joomla backend, open Content → Site Modules and click New.
3. Choose the module type Custom.
4. Switch the editor to code view with Toggle Editor and paste the code.
5. Pick a Position in your template and, under Menu Assignment, the page where the map should appear.
6. Save and check the page in the frontend.

<iframe src="https://app.my-store-locator.com/#/m/YOUR-TOKEN" title="Store locator" style="width:100%;height:640px;border:0;max-width:100%" loading="lazy" allow="geolocation"></iframe>

Alternative: inside an article

You can also paste the code into an article. Switch the editor to code view first. Joomla filters HTML per user group: under System → Global Configuration → Text Filters you decide whether a group may save iframes. Super Users have no filtering by default.

Privacy: two-click consent

In Embed Studio, turn on "Load the map only after a click (GDPR)" and copy the code again. Visitors then see a placeholder with a privacy notice first, and the map only loads after a click. More under GDPR & security.

If the map does not show up

• Code disappears after saving: your user group's text filter removes iframes. Adjust the filter or have a Super User paste the code.
• Module not visible: check position, menu assignment and status ("Published").
• "Map not available": the map is still a draft. Publish it in the app.
• Content Security Policy: if your site sends a CSP, frame-src must allow app.my-store-locator.com (for the widget also script-src).

All options are explained in the embedding guide.

FAQ