FeaturesUpdated 2026-08-25
Show product availability by store
What this article helps you do
Assign products to stores and add the product-availability block to your theme. The block shows shoppers which stores have a specified product.
Before you start
- Mapstore is installed.
- Mapstore has one or more stores.
- You assigned products to stores in the store form.
- You use the Shopify Online Store theme.
Step-by-step instructions
1. Assign products to stores
- Go to Stores.
- Open a store.
- In the Product assignments or Products section, add the products this store carries.
- The first time you select products, Shopify can request product-catalog access for Mapstore.
- Accept the request to open the product picker.
- Save the store.
- Do the procedure again for other stores. You can assign a product to more than one store.
2. Add the product availability block
- Go to Shopify Admin -> Online Store -> Themes -> Customize.
- Open a product template (or the product page).
- Add a new App block.
- Select Mapstore product availability or Product availability.
- If necessary, configure the button and drawer text.
- 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 select whether Mapstore shows email and phone links for a store.
4. Verify the block
On a product page with the block, shoppers see a button. When a shopper clicks the button, a drawer shows stores that have the product.
How to verify it worked
- Open a product page that has the block and has products assigned to one or more stores.
- Click the availability button.
- Make sure that a drawer opens and shows store names, addresses, and directions links.
- If a product has no stores assigned, the block shows an “unavailable” message.
Troubleshooting
| Issue | Fix |
|---|---|
| Block shows “no stores” for a product | Assign that product to one or more active stores in the Stores section. |
| Assigned stores are not shown | Open each store. Make sure that the store is Active. Check the product assignment. |
| Product picker does not open | Select products again and accept the product access request. Mapstore requests access only when you open the product picker. |
| Block is not on the product page | Make sure that the block is on a product template and is enabled. |
| Block says it only renders on product pages | The theme editor can show this message. Test on the live product page. |
| Directions or contact info missing | Add a directions URL, email, or phone on the store record. |
| Labels do not update | Save the theme. Refresh the product page. |
| Block is hidden or empty | The block hides when no product handle is available, such as on a page that is not a product page. |