Add the Duda store locator
Back up the site first. Duda recommends a backup before adding any custom code, so a mistake is one restore away.
- Import the client's locations and style the widget in the locator dashboard, then copy the snippet from Embed & Install.
- In the Duda editor, add a full-width row or container on the locations page.
- Drag the HTML widget into it. Duda suggests a container of its own so the widget can be removed cleanly if needed.
- Right-click the widget and choose Edit Content (or use the floating menu in Editor 2.0), then paste the snippet into the text box.
- Preview, publish, and check the live page.
Duda's rules for custom code, and how the locator meets them
Duda's support team will not debug custom code, so check against the published page and ask the locator vendor if something is off.
| Duda's rule for the HTML widget | What it means for a locator |
|---|---|
| Server-side scripts have no effect; use client-side code | The locator is a browser script, so it runs as intended |
| The editor uses HTTPS, so non-HTTPS files will not load | The widget and its data are served over HTTPS |
| Do not load another version of jQuery | The widget does not use jQuery, so it cannot clash with Duda's |
| Badly written code can make the widget inaccessible in the editor | Keep the locator in its own container so it is easy to select and delete |
Running locators for many Duda clients
Agencies on Duda often build the same kind of page for many clients: a franchise, a dealer network, a group of clinics. The locator model fits that: one locator account per client, each with its own locations, brand and map key, so a client's data and map bill are always theirs.
The time sink is upkeep, not setup. Clients send hours changes and new branches by email. Two things shorten that loop. A client's own Google Sheet can be the source, synced every 15 minutes, hourly or daily, so they edit the sheet and the locator follows. Or the agency asks ChatGPT or Claude to make the change against that client's locator: add these three addresses, mark these two closed on Sundays. Design changes are proposed with the exact before-and-after and only go live when someone confirms.
The agency page describes how Handled works with agencies, and the Yext reseller guide compares that with reselling an enterprise listings platform.
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 Duda
On Duda, Handled Locator is the embed described above: one HTML widget in its own container, with nothing for Duda's editor to conflict with. 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.
Connected data in Duda's HTML widget can also vary the embed per dynamic page. The snippet takes a tag list and a starting place, so a dynamic page per region or product line can show only its own locations.
Sources
Duda Support, Widgets: HTML. Read on 15 November 2026.
Frequently asked questions
How do I add custom code to a Duda page?
Use the HTML widget: add it to the page, open Edit Content, paste the code and publish. Duda recommends a backup first and a container of its own for the widget.
Will a store locator conflict with Duda's jQuery?
Not this one. Duda warns against loading another jQuery version; the locator does not use jQuery at all.
Can one agency manage locators for many Duda clients?
Yes, with one locator account per client. Each keeps its own locations, design and map key, and the agency can update them from the dashboard, a synced sheet, or ChatGPT and Claude.