Docs

1. Create your locator

Sign up, add your locations, and publish a widget from the dashboard. Every widget gets its own id, used to embed it below.

2. Embed it on your site

Paste this where you want the locator to appear, replacing YOUR_WIDGET_ID with your widget's id — find the exact snippet (with your id already filled in) on the widget's page in the dashboard.

JavaScript embed (recommended)

<div data-shopmaps="YOUR_WIDGET_ID" style="height:520px"></div>
<script src="https://cdn.shopmaps.app/widget.js" async></script>

iframe fallback

<iframe
  src="https://embed.shopmaps.app/w/YOUR_WIDGET_ID"
  style="width:100%;height:520px;border:0"
  loading="lazy"
  title="Store locator"
></iframe>

The script embed mounts inside an isolated shadow DOM, so it won't pick up or leak styles from the rest of your page — use the iframe if your site can't load a third-party script.

3. Customize

Colors, fonts, card layout, and map style are all controlled from the widget's Theme settings in the dashboard — changes show up on your site automatically, with nothing to re-embed.

Need the public API or webhooks?

Professional and Premium plans include public API access and webhooks for syncing locations from your own systems — see pricing for details.

Have more questions?

See the FAQ for answers to common questions.