Add store filters

What this article helps you do

Add filter tags to stores so shoppers can refine search results on your store locator. You can also show a country selector when your active stores span multiple countries.

Before you start

• Mapstore is installed.
• Mapstore has stores.
• The map block is on your store-locator page.
• You know the categories or attributes that shoppers must use as filters.

Step-by-step instructions

1. Add filter tags to stores

1. Go to Stores in Mapstore.
2. Open a store or create a store.
3. In Filters, enter one label, such as Wheelchair accessible.
4. Click Add.
5. Do the procedure again for each other label.
6. Save the store.

2. Add filters to more stores

• Do the procedure again for each store that must have a filter.
• Use one tag name for one meaning. For example, always use “wheelchair accessible” for the same attribute.

Mapstore does not show empty filter values on storefront store cards.

3. Enable filter tags on the storefront

1. In Mapstore, go to Settings.
2. Open Map.
3. Enable Show filters.
4. Save your changes.

4. Enable the country filter (optional)

1. In the same Map settings, enable Show country filter.
2. Save your changes.

Mapstore shows the country selector when active stores with coordinates are in two or more countries. When a shopper selects a country, Mapstore limits the results and moves the map.

5. Review what shoppers see

• Visit your store locator.
• Apply each filter.
• If you enabled the country filter, select a country.
• Make sure that the list and map update.

6. Give filter pins their own colors (optional)

1. Go to Settings -> Map -> Filter colors.
2. Select a filter.
3. Select a color.
4. Add the mapping.
5. Save the settings.
6. Refresh the storefront.

Filter colors apply to built-in individual pins. Custom marker images and clusters keep their existing styles. If a store has more than one filter, the first filter listed on that store that has a color takes priority.

How to verify it worked

1. Open a store in Mapstore.
2. Make sure that its Filters field has tags.
3. Open the store locator on the storefront.
4. Apply a filter.
5. Make sure that the list and map show only stores with that tag.

Troubleshooting

Related articles

• Add or edit stores
• Find stores in Mapstore
• Add custom fields
• Add Mapstore to your theme