# Square Online store locator: the Embed code section and the plan it needs

Source: https://locator.handledlocal.com/resources/store-locator-for-square-online

How to add a store locator to a Square Online site with the Embed code section, why it needs a Plus or Premium plan, and what to do if you are on the free plan.

Platform guide. Published 2026-11-15. 7 min read.

## In short

On Square Online, a store locator goes into an Embed code section on a page. Square's help article states that embedded code is available to Square Online Plus and Premium subscribers, so on the free plan you cannot add a third-party locator at all.

With Plus or Premium: in the site editor, choose Add, then Section, then Embed code, paste the snippet and publish. Square does not support custom code itself, so test on the published site.

A locator is for a list that goes beyond your own Square locations: stockists, dealers, or a searchable list of many branches with filters.

## Check your plan first

Square's article on embedded code is written for Square Online Plus and Premium subscribers, and for account owners or team members with online permissions set in Square Dashboard. If you are on the free plan, the Embed code section is not available, and no locator vendor can change that. Upgrading is one answer; a free map of your Square locations is the other.

If your site started on Weebly and still uses the classic Weebly editor, the [Weebly guide](https://locator.handledlocal.com/resources/store-locator-for-weebly) applies instead.

## Add the Square Online store locator

These are the steps from Square's own article, with the locator's part added at the start.

1. Import your locations and style the widget in the locator dashboard, then copy the snippet from Embed & Install.
2. Sign in to Square Dashboard and go to Channels, then Square Online, then Website, then Edit site.
3. Open the page where the locator belongs.
4. Select Add, then Section, then choose Embed code.
5. In the editing panel, select Embed code and paste the snippet into the text box.
6. Publish, then open the live page.

## Square Online quirks

Most install problems on Square Online are a snippet pasted in part. Paste the whole thing.

- Square warns that incomplete or invalid code can break your site. If something goes wrong, delete the section, republish, and check with the code provider.
- Square's support does not help with the code itself; the locator vendor does.
- Header and footer code is a separate setting in Square Dashboard meant for tracking. The locator belongs in a page section, not there.

## Checks before you call it done

On the published site.

- Open the published page in a private window, not the editor. Most builders do not run third-party scripts while you edit.
- Search your busiest town and a town you do not serve, and read both results.
- Open it at phone width and use it one-handed.
- Tap a phone link and a directions link on a real phone.
- Run Check installation in the Handled dashboard against the public URL. Setup completes when the locator has loaded on that page.

## Where Handled Locator fits on Square Online

On Square Online, Handled Locator is the embed described above: one Embed code section on a Plus or Premium plan. Locations come from CSV, the dashboard, or a sync from Google Sheets, Airtable, Webflow CMS or HubSpot. The map runs on your own Mapbox or Google Maps key, billed by the provider with nothing added. Plans are $19, $39 and $79 a month for 200, 2,000 and 10,000 locations, after a 7-day trial with no card. You can also run it from ChatGPT or Claude: add locations, restyle the widget and get the embed code by describing what you want, with every design change shown before it goes live.

It does not read your Square locations or connect to Square pickup. It is the right tool when the list is bigger than your own Square locations, such as the shops and cafes that stock your product.

## Sources

Square Support, [Add external content and widgets with embedded code in Square Online](https://squareup.com/help/us/en/article/6899-add-external-content-and-widgets-with-embedded-code-in-square-online-store). Read on 15 November 2026.

## Frequently asked questions

### Can I embed code on Square Online's free plan?

No. Square's help article makes embedded code available to Square Online Plus and Premium subscribers.

### Where is the Embed code section in Square Online?

In the site editor, select Add, then Section, then Embed code. Paste the code in the editing panel and publish.

### Can the locator show my Square locations automatically?

No. Import them once from a CSV or a sheet. The locator is designed for lists beyond your own Square locations, such as stockists and dealers.
