# Ecwid store locator: Instant Site, or the site Ecwid is embedded in

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

Where a store locator goes on an Ecwid store: a custom code section on Instant Site on the plans that allow it, or the website your Ecwid store is embedded into.

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

## In short

Ecwid stores live in one of two places, and the locator goes wherever the pages are. If you use Ecwid's own Instant Site, add a custom code section to a page. Ecwid lists that feature on its Venture, Business and Unlimited plans, and it is not supported on the legacy version of Instant Site.

If your Ecwid store is embedded into a WordPress, Wix, Squarespace or other site, ignore Ecwid for this job: add the locator to a page of the host site, using that platform's own embed element.

Avoid Instant Site's site-wide body code for the locator. Ecwid states that content added there appears at the bottom of the page on every page, which is the wrong place for a store finder.

## First: where does your Ecwid store live?

The table is the whole decision. The rest of this page covers the Instant Site route.

| Your setup | Where the locator goes | Guide |
| --- | --- | --- |
| Ecwid Instant Site, current version, Venture plan or higher | A custom code section on a page | This guide |
| Ecwid Instant Site on a plan without custom code, or the legacy Instant Site | Not possible in Instant Site; upgrade, or host the page elsewhere | This guide, below |
| Ecwid embedded in WordPress | A Custom HTML block or the official plugin | [WordPress store locator](https://locator.handledlocal.com/wordpress-store-locator) |
| Ecwid embedded in Wix, Squarespace or another builder | That builder's embed element | [All platform guides](https://locator.handledlocal.com/guides#install) |

## Add the locator to Ecwid Instant Site

These steps follow Ecwid's own article for adding a custom code section to one page.

1. Import your locations and style the widget in the locator dashboard, then copy the snippet from Embed & Install.
2. From your Ecwid admin, go to Website, then Edit Site, and choose the page (a Stores or Find us page works well).
3. Click Add Section and scroll to Advanced Solutions. In the Embed and Custom Code block, add a custom code section.
4. Paste the snippet into the section's field.
5. Drag the section into position and publish.
6. Open the published page and run the checks below.

## If your plan does not include custom code

Ecwid's help article lists custom code on the Venture, Business and Unlimited plans. On a plan without it there is no supported way to run a third-party locator script inside Instant Site, and this page will not pretend otherwise.

Two honest options remain. Upgrade the Ecwid plan, if the other features are worth it to you as well. Or keep the store on Ecwid and put the locations page on a site that does accept embed code, then link to it from the Instant Site menu. Ecwid itself is designed to be embedded into other sites, so this split is a normal Ecwid setup rather than a workaround.

## Checks before you call it done

On the published Instant Site page.

- 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 Ecwid

On Ecwid, Handled Locator is the embed described above: a custom code section on Instant Site, or the host site's embed element if Ecwid is embedded somewhere else. 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.

The locator does not connect to Ecwid's catalog or local pickup. It is a list of places with search, filters, hours and directions, kept outside Ecwid so it survives any change to where the shop is hosted.

## Sources

Ecwid Help Center, [Adding custom code to Instant Site](https://support.ecwid.com/hc/en-us/articles/8359349900828-Adding-custom-code-to-Instant-Site). Read on 15 November 2026.

## Frequently asked questions

### Can I add a store locator to Ecwid's free plan?

Not inside Instant Site. Ecwid lists custom code on its Venture, Business and Unlimited plans. You can still host a locations page on another site and link to it.

### Where do I add custom HTML in Ecwid?

On Instant Site, use Add Section, then Advanced Solutions, then the Embed and Custom Code block. Site-wide header and body code fields exist too, but body code appears at the bottom of every page.

### My Ecwid store is inside WordPress. Where does the locator go?

On a WordPress page, not in Ecwid. Use a Custom HTML block or the official Handled Locator plugin.
