Store Locations

What this section does

The Store Locations page gives shoppers a full store locator experience:

1. Search by city, state, store name, phone, email, product keywords, or hours text.
2. Filter by Open now.
3. Filter stores by products available in each showroom.
4. See matching stores in a list and on an embedded map.
5. Open directions or a store detail page from each store card.

How to set it up

1. Go to Online Store -> Themes.
2. Click Customize.
3. Open the page using the page.store-locations template.
4. Select Page - store locations.
5. Configure page-level labels and text.
6. Add and configure Store blocks.
7. Save.

If you do not have a storefront page using this template yet:

1. Create a page in Online Store -> Pages.
2. Assign template page.store-locations.
3. Save and preview.

Editor areas overview

1. Left sidebar:
   • Contains the section and all Store blocks.
   • Use Add block -> Store to add locations.
   • Drag blocks to reorder store cards.
2. Center preview:
   • Shows live search/filter behavior, store list, and map updates.
3. Right settings panel:
   • Page-level text and label controls.
   • Per-store block settings for contact info, status, products, links, and coordinates.

Key section settings explained

1. Search placeholder: helper text in the main search input.
2. Open now filter label: label for the open-status checkbox.
3. Product filter label: title for the product filter dropdown.
4. Product search placeholder: placeholder in product filter search.
5. Product search empty text: shown when no product filter options match search.
6. Selected products label: heading above selected product filter chips.
7. Clear filters button label: button text shown when filters are active.
8. No results text: shown when current filters return zero stores.
9. Directions button label: text used on each card directions action.
10. Store details button label: text used on each card details action.
11. Empty state text: shown when no Store blocks exist yet.

Store block settings explained

For each Store block, configure:

1. Store name, Address, City / state, Phone, Email.
2. Hours label and Opening hours.
3. Status (Open or Closed) used by the Open now filter.
4. Available products (comma or line-separated) used by product filtering.
5. Directions URL for map apps.
6. Store details page URL for the detail page button.
7. Latitude and Longitude for precise map pin placement.

Important behavior

1. Open now is manual: it depends on each store block’s Status, not real-time clock logic.
2. Product filter appears only when product data exists: if no stores have Available products, the product filter is hidden.
3. Map source priority: the map uses latitude/longitude when available; otherwise it falls back to address + store name query.
4. Active store sync: selecting a visible card updates the map location immediately.
5. Auto-selection after filtering: when filters change, the first visible store becomes active.
6. Store details URL fallback: if details URL is blank, the theme derives a /pages/<handle> style path from store name; create matching page handles to avoid broken links.

How shoppers use it

1. Enter a location or store keyword in search.
2. Turn on Open now to show open locations only.
3. Use Filter by product to narrow by available showroom inventory.
4. Click a store card to focus it on the map.
5. Use Get directions or View store details.
6. Switch map mode between Map and Satellite.

Common tasks

Add a new showroom

1. In the section, click Add block -> Store.
2. Fill contact, hours, status, links, and coordinates.
3. Save and verify card + map pin.

Enable accurate product filtering

1. Add product names in Available products for every store.
2. Keep naming consistent across stores.
3. Save and test product filter search and selection.

Fix wrong map pin location

1. Update Latitude and Longitude in the store block.
2. Save and re-open the card in preview.
3. Confirm map pin now matches the showroom.

Prevent details-page dead links

1. Set Store details page URL explicitly to a valid page.
2. If left blank, ensure derived handle pages exist.
3. Save and test each View store details button.

Tips

1. Keep status updated daily if you use the Open now filter.
2. Use consistent product naming so merchants and shoppers can find items faster.
3. Keep opening hours format consistent across stores for readability.
4. Fill coordinates for every store for the most reliable map behavior.

FAQs

Why does Open now show a store that is currently closed in real life?

Because this filter uses the block Status setting, not current time calculations.

Why is the product filter missing?

No store currently has values in Available products.

Why does map position look wrong for one store?

That store likely has incorrect or missing Latitude/Longitude values.

Why does View store details open a missing page?

The details URL is invalid, or a fallback handle was generated for a page that does not exist.

Related guides

• Store Detail Page Documentation
• Header Documentation
• Theme Documentation
• Contact page

Publish checklist

1. Confirm page uses page.store-locations template.
2. Validate all store contact details and links.
3. Validate status values for each store.
4. Test search, open-now filter, and product filter.
5. Verify each map pin and each details page URL.
6. Test desktop and mobile behavior before publishing.

Need help?

If you still need help, contact support via the Contact page.