Install the store locator
A directory of your stores: search, an interactive map, live opening hours, the visitor's distance and, for stores that take appointments, a "Book an appointment" button. Place it on an "Our stores" page, a footer, a landing page, or any page of your own sites.
Publish it first
The store locator stays empty until you publish it: turn on Store directory in the Store locator page of your dashboard, which also shows a live preview (also in Settings > Company > Stores, where your stores, their opening hours and their services are managed). It is public as soon as it is on.
Whitelist your domain
Outside the Shopify page, the locator only loads on domains whitelisted in the URL whitelist page of your dashboard. Add every environment you embed on (prod, staging, preview, etc.).
Pick your integration path
- Shopify theme block: no HTML to paste. See Shopify theme block.
- Any other page or site: paste the embed code. See Copy-paste.
- Ready-made Shopify page:
/a/humind/stores, served by the Humind app. See Shopify page.
The chat widget can also show the locator in a Stores tab: turn on Show in the chat widget under the store directory switch (or store_locator.chat_tab in the settings API). Nothing to install for that one; its Book an appointment opens the chat's booking card.
Shopify theme block
In the theme editor, add the Store locator app block to any template (a page template for an "Our stores" page is the usual choice). The Store locator page of your dashboard has an Install on Shopify button that opens the theme editor with the block ready to drop.
The block finds your company from the storefront and its market on its own. Its settings are an optional accent color (empty = your Humind brand color) and the margins.
Copy-paste
<script src="https://widgets.thehumind.com/v1/loader.js" defer></script>
<humind-store-locator company-id="YOUR_COMPANY_ID"></humind-store-locator>The dashboard's Store locator page gives you this snippet with your company ID filled in. You can also grab the ID from the Developer Credentials page.
The locator takes the full width of its container. Give the container the width you want; the map and the list stack on narrow screens.
Shopify page
Every published locator also gets a full page on a Shopify storefront, at https://your-store.com/a/humind/stores (the path changes if you renamed the app proxy in Shopify). Add it to your navigation menu like any other link. Its Book an appointment opens the chat widget's booking card, as on the theme block.
Appointments
A store shows Book an appointment when it takes appointments and the appointment booking skill is on for your assistant (the same switch as the chat widget's Appointment tab). On the theme block, the copy-paste embed and the Shopify page, the button opens the Humind chat widget on its booking card for that store. If the chat widget is not on the page, nothing opens: listen to the event below to drive your own booking flow (the button still needs the appointment booking skill on).
To keep booking out of the locator, turn off Appointment booking under the store directory switch (or store_locator.booking in the settings API).
Attributes
| Attribute | Type | Purpose |
|---|---|---|
company-id | string | Your Humind company ID. Use this or shop-domain. |
shop-domain | string | Alternative to company-id: a domain registered on your company. Set automatically by the Shopify theme block (shop.permanent_domain). |
market-key | string | Multimarket setups only: names the market when several markets share one domain. Set automatically on Shopify. See several markets on one domain. |
language | string | ISO 639-1 code. Supported: en, fr, de, es, ar, it, nl, pt, ru, zh, he. |
accent-color | string | Overrides your brand color (buttons, selected store). |
accent-text-color | string | Overrides the text color shown on the accent color. |
Events
| Event | Target | When |
|---|---|---|
humind-store-appointment | bubbles to window | The visitor clicked Book an appointment on a store. |
humind-store-appointment detail
{
storeId: string;
storeName: string;
address: string;
bookable: boolean; // the store takes appointments
inPlace: boolean; // the locator books it itself (always false: booking goes through the chat)
}window.addEventListener('humind-store-appointment', (event) => {
console.log(event.detail.storeId, event.detail.storeName);
});