Features Updated 2026-02-22

Track where a product is available across stores

What this article helps you do

Let shoppers see which store locations carry a specific product by assigning products to stores and adding the product availability block to your theme. When clicked, it shows a list of stores that have that product assigned.

Before you start

  • Mapstore is installed and you have at least one store
  • Products are assigned to stores (via the store edit form)
  • You use the Shopify Online Store theme

Step-by-step instructions

1. Assign products to stores

  1. Go to Stores and open a store.
  2. In the Product assignments or Products section, add the products this store carries.
  3. Save the store.
  4. Repeat for other stores. A product can be assigned to more than one store.

2. Add the product availability block

  1. Go to Shopify Admin -> Online Store -> Themes -> Customize.
  2. Open a product template (or the product page).
  3. Add a new App block and choose Mapstore product availability or Product availability.
  4. Configure the button and drawer text if needed.
  5. Save.

3. Configure what shoppers see

With the product availability block selected, you can adjust labels such as:

  • Button label
  • Drawer title
  • Loading text
  • Empty state text
  • Directions label
  • Email and phone labels
  • Close button label
  • Error text

You can also choose whether email and phone links appear when those fields are available on a store.

4. Confirm it works

On a product page where the block is placed, shoppers should see a button. Clicking it opens a drawer with the list of stores that carry that product, including address, directions link, and optional email/phone.

How to verify it worked

  1. Open a product page that has the block and has products assigned to at least one store.
  2. Click the availability button.
  3. A drawer should open showing store names, addresses, and directions links.
  4. If a product has no stores assigned, the block shows an “unavailable” message.

Common issues and fixes

IssueFix
Block shows “no stores” for a productAssign that product to one or more active stores in the Stores section.
Stores are assigned but still missingRe-open each store and confirm the store is Active and the product assignment was saved.
Block does not appearEnsure the block is added to a product template and the block is enabled.
Block says it only renders on product pagesThis can appear in the theme editor. Test on the live product page.
Directions or contact info missingAdd a directions URL, email, or phone on the store record.
Labels do not updateSave the theme and refresh the product page.
Block hidden or emptyThe block hides itself when no product handle is available (e.g. not on a product page).