Before you install
Add at least one visible location, review the design and connect the selected map provider. The Shopify page can be created earlier, but the public map cannot render until the provider key is valid for the storefront domain.
Copy the embed
Open Embed & Install, select Shopify, then copy the complete snippet shown for your account. It contains the real site ID; do not copy the placeholder below into production.
Shape of the embed
<div id="biz-locator-root"></div>
<script
src="https://cdn.handledlocal.com/widget.js"
data-site-id="your-site-id"
async
></script>Add it to Shopify
- 1
Open the locations page
In Shopify, go to Online Store → Pages and open or create the page that should contain the locator. - 2
Show the HTML
Switch the content editor to Show HTML, then paste the complete Handled snippet where the locator should appear. - 3
Save the page
Save, add the page to storefront navigation if needed, and open the public storefront URL.
Verify the public page
Return to Embed & Install and run Check installation against the exact public URL. Handled checks that the script loads, the site ID is valid, visible locations are returned and a real external view has reached the account.
