Home / Setup tutorial

Setup tutorial

Get your stockist map live

Eight steps from install to a working map on your storefront. Most stores are done in about five minutes.

Updated 20 November 2026. Stuck on a step? Email [email protected].

1

Install the app

Find Saol - Stockist Map Sync on the Shopify App Store and click Install. The app asks for access to your customers, so it can read the ones you tag, and to your online store, so it can show the map.

You start on Free up to 25 locations. There is nothing to pay and no key or outside account to create.

2

Choose your tag

Open the app and go to Settings. Under Customer Tags you will see the default tag, stockist. Keep it, or add your own.

You can use more than one tag. For example, add stockist and retailer and a customer with either tag is synced. Tags with a space in them work too.

3

Tag your stockist customers

In Shopify admin, go to Customers, open each stockist and add your tag. The app uses the customer's default address, so check it is complete. The name on the map is the Company on that address, so put the shop's name there. If it is empty, the customer's own name is shown.

Back in the app, click Sync tagged customers on the dashboard. Each tagged customer becomes a location on the map.

From then on the map looks after itself. When a tagged customer changes in Shopify, a webhook updates the map, and a nightly re-check catches anything that was missed. Remove the tag and the location is removed.

4

Add retailers who are not customers

Not every stockist has a customer record. You have two other ways to add a location:

  • By hand. Click Add location, type the name and address, and save.
  • By CSV. Go to Import CSV, download the template, fill it in and upload it.

The CSV columns are name, address1, address2, city, province, country, zip, phone, hours, website, description, category, latitude and longitude. Headers such as Suburb, State and Postcode are accepted as well, so an Australian spreadsheet usually imports as it is.

Addresses are turned into map coordinates for you during the import.

A CSV can also add details to stockists you already have, including ones synced from customers. A file with just name and hours columns sets everyone's opening hours in one go. Type hours as a line such as Mon-Fri 9-5, Sat 9-3 and each stockist gets its Open or Closed badge.

5

Add the details shoppers look for

Open any location from the Locations page to add or change:

  • the name shown on the map
  • phone number and website
  • opening hours, which give the location an Open or Closed badge
  • a short description
  • a category, which becomes a filter button above the map once two or more categories are in use, and shows as a tag on the stockist's list entry and popup

You can also hide a location from the map without deleting it.

6

Edit many locations at once

On the Locations page, export your locations to CSV. Open the file in a spreadsheet, make your changes and upload it on the import page. The same locations are updated in place, whether they came from a tagged customer, an import or were added by hand. Change an address and the location moves on the map.

A re-import only changes the columns your file contains, so details you edited in the app are kept.

7

Set the look of the map

In the app's Settings:

  • Map style. Eleven to choose from: Classic, Bright, Simple, Muted, Light, Soft grey, Ink, Dark, Charcoal, Midnight and Navy. New installs start on Classic.
  • Marker colour. Set it to your brand colour: pick it, or type its hex code.
  • Marker clustering. Groups nearby locations into one marker until the shopper zooms in.
  • Filters. List the customer tags you want as filter buttons, for example boots, workwear, outdoor. A stockist carrying one of those tags is filed under it, so you do not need to type a category on each location. Tags you do not list stay private.
  • Search. Show or hide the search box, set the search radius and choose kilometres or miles. Shoppers can search a suburb, a postcode or a stockist's name. After a search, locations within the radius are listed, nearest first.
8

Add the map block to your theme

The quickest way is the Add the map to my theme button on the app dashboard. It opens the theme editor with the map block already added to your default page template, so the map shows on every page that uses that template. For a page of its own, follow the steps below and create a template for it.

To do it yourself:

  1. Create a page in Online Store > Pages called Stockists or Where to buy.
  2. Go to Online Store > Themes > Customize and open that page's template.
  3. Click Add section or Add block, look under Apps and choose Saol Stockist Map.
  4. Choose a layout: full-width map, map left with a list, or map right with a list. You can also set the heading, the map height and whether the list is grouped by state or region.
  5. Save.

The map block works on Online Store 2.0 themes. On an older vintage theme, email support first and we will check.

You are live

Open the page on your storefront. Shoppers can search by suburb, postcode or stockist name with suggestions as they type, or tap Use my location, filter by category, see opening hours, and tap through for a phone number, website or directions.

Add a link to the page in your main menu and footer so it is easy to find.

If you go over your limit. Free covers up to 25 locations, Pro up to 250 and Business is unlimited. Locations over the limit are hidden, not deleted, and come back when you upgrade. See pricing.

Need a hand?

Email [email protected]. Support is answered by the developer, usually within one business day, Brisbane time.

Ready to add your stockist map?

Install free, tag your first stockist, and watch the location appear. Nothing to pay until you need more than 25 locations.

Install free on Shopify