Title: Handled Locator – Store Locator Map Author: Handled Locator Published: August 24, 2026 Last modified: August 24, 2026 --- Search plugins ![](https://ps.w.org/handled-locator/assets/banner-772x250.png?rev=3663735) ![](https://ps.w.org/handled-locator/assets/icon-256x256.png?rev=3663735) # Handled Locator – Store Locator Map By [Handled Locator](https://profiles.wordpress.org/handledlocal/) [Download](https://downloads.wordpress.org/plugin/handled-locator.1.0.0.zip) * [Details](https://wordpress.org/plugins/handled-locator/#description) * [Reviews](https://wordpress.org/plugins/handled-locator/#reviews) * [Installation](https://wordpress.org/plugins/handled-locator/#installation) * [Development](https://wordpress.org/plugins/handled-locator/#developers) [Support](https://wordpress.org/support/plugin/handled-locator/) ## Description Handled Locator adds a searchable store locator to your WordPress site. Visitors search by town or postcode, filter by category, see opening hours in each location’s own timezone, and get directions. Add it with the **Handled Locator** block, or the `[handled_locator]` shortcode. #### Bring your own map key Most store locators bill you for map usage on top of their subscription, or cap how many map views you get. Handled Locator uses **your own** Mapbox or Google Maps key, so map traffic is billed at cost by the map provider, with no markup from us and no view ceiling. #### What visitors get * Search by town, postcode or address * Filter by category * Opening hours, with an open-or-closed badge computed in the location’s own timezone * Directions, call and website actions * Works on phones — the layout stacks rather than shrinking #### What you get * Import locations from a spreadsheet, with duplicate detection and address geocoding * Style it to match your site: colours, fonts, corners, spacing * One line of setup in WordPress, then manage everything from your Handled Locator dashboard #### Requires a Handled Locator account This plugin displays a locator that is configured and hosted at [locator.handledlocal.com](https://locator.handledlocal.com).** A Handled Locator account is required for the plugin to display anything.** There is a 7-day free trial with no card required. After the trial, paid plans start at $19/month. The plugin itself is free and open source under GPLv2. ### External services This plugin relies on the Handled Locator service to render your store locator. It is not usable without it. **What is loaded, and when** 1. **Widget script.** On any page containing the Handled Locator block or shortcode, the plugin loads a JavaScript bundle from `https://cdn.handledlocal.com/widget. js`. This is the code that renders the locator. 2. **Location data.** That script then requests your published locations from the Handled Locator API at `https://app.handledlocal.com/api/public/locations`, identified by the Site ID you configure in the plugin settings. **What is sent** The requests are made by the visitor’s browser. They include the Site ID you configured, and — as with any web request — the visitor’s IP address and user agent. Nothing about your WordPress users, posts, or site content is transmitted. The plugin does not send anything from your server. If a visitor uses the optional “near me” feature, their browser asks them for location permission and the coordinates are used to sort results. This only happens if they grant permission. **Terms** * Terms of service: https://locator.handledlocal.com/terms * Privacy policy: https://locator.handledlocal.com/privacy ## Screenshots [⌊The locator on a published page: search, category filters, opening hours with live status, directions, and clustered map pins styled to the site.⌉⌊The locator on a published page: search, category filters, opening hours with live status, directions, and clustered map pins styled to the site.⌉[ The locator on a published page: search, category filters, opening hours with live status, directions, and clustered map pins styled to the site. [⌊The Handled Locator block in the editor, with the optional per-page Site ID override.⌉⌊ The Handled Locator block in the editor, with the optional per-page Site ID override .⌉[ The Handled Locator block in the editor, with the optional per-page Site ID override. [⌊Plugin settings. Paste your Site ID and you are done.⌉⌊Plugin settings. Paste your Site ID and you are done.⌉[ Plugin settings. Paste your Site ID and you are done. ## Blocks This plugin provides 1 block. * Handled Locator A searchable store locator map. Uses the Site ID from Settings unless you override it here. ## Installation 1. Install and activate the plugin. 2. Create a Handled Locator account at [locator.handledlocal.com](https://locator.handledlocal.com) and add your locations. 3. Copy your Site ID from the Install screen in your Handled Locator dashboard. 4. In WordPress, go to **Settings Handled Locator** and paste the Site ID. 5. Add the **Handled Locator** block to a page, or use the `[handled_locator]` shortcode. ## FAQ ### Do I need an account? Yes. The locator itself is configured and hosted by Handled Locator, so the plugin needs a Site ID from an account to display anything. The trial is 7 days and does not ask for a card. ### Can I put the locator on more than one page? Yes. Add the block or shortcode wherever you want it, as many times as you like. ### Can I show a different locator on different pages? Yes. The shortcode takes an optional override, `[handled_locator site_id="..."]`, and the block has a Site ID field in its sidebar. Leave both empty to use the Site ID from Settings. ### Do I need a map key? You bring your own Mapbox or Google Maps key, which you add in your Handled Locator dashboard rather than in WordPress. That is what keeps map usage billed at cost with no markup. ### Does it work with my theme? The locator renders inside a shadow root, so your theme’s CSS cannot leak in and break it, and its styles cannot leak out and affect your page. It picks up your site’s font so it does not look pasted in. ### Does it slow my site down? The widget script is only loaded on pages that actually contain the block or shortcode, and it loads asynchronously in the footer, so it does not block rendering. ## Reviews There are no reviews for this plugin. ## Contributors & Developers “Handled Locator – Store Locator Map” is open source software. The following people have contributed to this plugin. Contributors * [ Handled Locator ](https://profiles.wordpress.org/handledlocal/) [Translate “Handled Locator – Store Locator Map” into your language.](https://translate.wordpress.org/projects/wp-plugins/handled-locator) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/handled-locator/), check out the [SVN repository](https://plugins.svn.wordpress.org/handled-locator/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/handled-locator/) by [RSS](https://plugins.trac.wordpress.org/log/handled-locator/?limit=100&mode=stop_on_copy&format=rss). ## Changelog #### 1.0.0 * Initial release: Handled Locator block, `[handled_locator]` shortcode, and settings screen. ## Meta * Version **1.0.0** * Last updated **23 hours ago** * Active installations **Fewer than 10** * WordPress version ** 6.0 or higher ** * Tested up to **7.1** * PHP version ** 7.4 or higher ** * Tags * [dealer locator](https://wordpress.org/plugins/tags/dealer-locator/)[locations](https://wordpress.org/plugins/tags/locations/) [map](https://wordpress.org/plugins/tags/map/)[store finder](https://wordpress.org/plugins/tags/store-finder/) [Store locator](https://wordpress.org/plugins/tags/store-locator/) * [Advanced View](https://wordpress.org/plugins/handled-locator/advanced/) ## Ratings No reviews have been submitted yet. [Your review](https://wordpress.org/support/plugin/handled-locator/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/handled-locator/reviews/) ## Contributors * [ Handled Locator ](https://profiles.wordpress.org/handledlocal/) ## Support Got something to say? Need help? [View support forum](https://wordpress.org/support/plugin/handled-locator/)