WP Store Locator

👉 Try the live demo · Documentation · Getting started · Add-ons · Add-on Bundle

• Works without Google Maps. Run the entire store locator on OpenStreetMap with no API key, no Google account and no credit card. Prefer Google Maps, Mapbox or Stadia Maps? Pick it from a dropdown. Your locations, settings and add-ons work with every provider.
• No code needed for custom data. The Fields Manager adds your own fields to the store editor and the Section Editor places them in the results, the info window or anywhere else on the front end.
• Design your own markers. The Marker Studio lets you create marker icons that match your brand instead of picking from a fixed set.
• Draw on the map. Polygons, circles, rectangles and lines for service areas, delivery zones or sales territories.
• A modern theme and an appearance editor. A new vertical layout, plus colours, call-to-action buttons and map styles you can change without touching CSS.
• Privacy built in. Hold the map back until the visitor consents, with your own text, or hand the decision to Borlabs Cookie or Complianz.
• Faster. Location data is loaded in a single batch and settings in a single query, so a locator with hundreds of locations stays quick.

• OpenStreetMap (Leaflet): Free. No API key. Optional free vector styles from OpenFreeMap, and inline routes with a free Openrouteservice key.
• Stadia Maps: Ten polished map styles, its own geocoder and routing, and an EU endpoints switch that keeps all requests inside the European Union.
• Mapbox: Design a map in Mapbox Studio, paste the style URL and the locator uses it. Ten styles ship out of the box, including satellite and navigation.
• Google Maps: Full support, now on the current Geocoding and Routes APIs, with Advanced Markers, cluster styling and the new Autocomplete Data API.

• Search by address, postcode, city, state or country, or by store name.
• Autocomplete as the visitor types, on Google Maps, Mapbox and Stadia Maps.
• Detect the visitor's location automatically, on page load or after they click the locate button.
• Radius, max results and category filters, as dropdowns or checkboxes.
• Combine categories with AND or OR logic, or pre-select a default category.
• Hide the address search and show only the category filter to turn the locator into a browsable directory.
• Sort by distance, name, address, city, postcode, state, country or ID, ascending or descending.
• Search for a whole country or state and get every location in it.
• No results in range? Show the nearest location anyway, however far.
• Keep results inside the searched country, so a border town does not return stores across the border.
• Show the number of results returned.
• Bias or restrict results to up to 15 countries.

• A landing page for every location, with one switch. No pages to create, shortcodes to place or code to write: every location gets its own page with a clean URL, so search engines and customers can link straight to a store.
• Address, phone, fax, email, URL, description, featured image and categories for every location.
• Structured opening hours with a live Open now / Closed badge, expandable to the full week.
• Custom hours text and a "special hours" field for holidays.
• Mark a store permanently or temporarily closed, with an automatic reopen date.
• Your own fields of any type: text, textarea, email, phone, URL, checkbox or dropdown, grouped the way you want them in the editor.
• Drag the marker to the exact spot, or type coordinates in by hand.
• Admin search by name, postcode, city, state or country, and sortable custom columns.

• Vertical or horizontal layout, with results beside or below the map.
• Appearance editor for colours, dimensions, call-to-action buttons and active map styles.
• Marker Studio for custom markers, plus per-category markers and a distinct active marker.
• Numbered or lettered markers that match the results list.
• Category colors, shown as a dot in the category filter and as colored labels in the search results.
• Marker clusters on every provider, with styled and colour-interpolated clusters on Google Maps.
• Section Editor to change the markup of the results list, info window, result count and online stores sections.
• Open the info window on hover or by clicking the address in the results.
• Every label and placeholder is editable, and any label can be hidden without losing the field.
• Improved accessibility, keyboard navigation and RTL support.

• Built-in consent placeholder with your own description text. No extra plugin required.
• Integrations with Borlabs Cookie and Complianz.
• Server-side geocoding on OpenStreetMap.
• EU-only endpoints on Stadia Maps.

• Store Locator and Map blocks for the block editor.
• [wpsl] for the full locator, with attributes for categories, filters, map style, markers, shapes, region and distance unit.
• [wpsl_map] for a map with one or more locations.
• [wpsl_address] and [wpsl_hours] to show the address, contact details or opening hours of a single location anywhere.

• Onboarding wizard for new installs, and automatic migration of 2.x settings.
• Home screen with a setup checklist and alerts for compatibility problems, missing keys or API errors.
• API key validation with the raw response shown, so key restrictions and billing problems are diagnosed in seconds.
• Import and export settings, reset data, clear caches and inspect geocode responses from the Tools section.
• Custom post types and taxonomies, more than 50 filters, template overrides and a helper to build your own custom-field filters.
• Compatible with WPML and Polylang.

1. Install and activate the plugin.
2. Follow the onboarding wizard. Pick OpenStreetMap to skip API keys entirely, or connect Google Maps, Mapbox or Stadia Maps. Then set a start location.
3. Add your locations under Store Locator > Add Store, or import them with the CSV Manager from the Add-on Bundle.
4. Add the Store Locator block or the [wpsl] shortcode to a page.

• CSV Manager: Bulk import, export and update locations from a CSV file.
• Search Widget: Let visitors search for the nearest store from any widget area and land on the results page.
• Statistics: See what people search for and where there is demand for a new location.

• Lifetime updates
• 12 months of technical support
• A free upgrade to WP Store Locator Pro when it launches
• A 30-day money-back guarantee

Please take a look at the documentation before making a support request.

• Getting Started
• Configure WP Store Locator
• Shortcodes
• Troubleshooting
• Customisations
• Filters

1. Upload the wp-store-locator folder to the /wp-content/plugins/ directory, or install it from the Plugins screen.
2. Activate the plugin through the 'Plugins' menu in WordPress.
3. Run through the onboarding wizard. Choose a map service under Store Locator > Settings > API. OpenStreetMap needs no key. For Google Maps, Mapbox or Stadia Maps, enter the key and click Validate API key.
4. Set the start location under Store Locator > Settings > Map.
5. Add your stores under Store Locator > Add Store.
6. Add the Store Locator block or the [wpsl] shortcode to a page.

• The wpsl_hour_dropdown_words filter adds words such as Sunrise and Sunset to the Opening Periods dropdowns. Sunrise and Sunset use the real time at the location for the open / closed status, other words only show as text.
• The 'wpsl_country_aliases' filter adds names a country is saved under, like [ 'GB' => [ 'Great Britain' ] ]. Changed
• The editor detects 12 or 24 hour time from the first day with times, so a location whose first day is text no longer opens in 24-hour mode.
• The editor saves a closed day as an empty array and a "24hrs" day as the string '24hrs', not as the translated text.
• current_status() can return the status 'unknown', with no message, on a day with text.
• The rows of the "Your setup" table at the end of the setup wizard alternate in color.
• The last step of the setup wizard shows the Learn more links as cards, with a short tip about the CSV Manager add-on. Fixed
• A day saved as "24hrs" or as your own text showed "Closed". It now shows the text.
• "24hrs" counted as closed. It now counts as open all day.
• "Hide days marked as closed" also hid days saved as text. It now only hides days that are closed.
• Nothing showed when every day was saved as text.
• Nothing showed when every day was closed and a Special hours note was set. The note shows now.
• "Open now" included locations whose status can't be known, such as hours with text, and locations closed every day. They are left out.
• A location that is closed today and whose only other hours are a day saved as text showed "Closed Opens" with nothing after it. It shows no status now.
• A search restricted to a country now also finds locations saved under another name of it, like UK, U.K., Great Britain or USA, whether the country is set as a code ( country="gb", country="uk" ) or as a name ( country="United Kingdom" ). The saved data is not changed.
• "Validate API keys" no longer keeps loading when Google rejects the browser key ( e.g. InvalidKeyMapError ). It shows the error instead.
• WPML and Polylang: after an update from 2.x, labels that were changed in 2.x, or whose default text changed in 3.0 ( "No results found" ), showed in the source language on every language. They show the translated default text again, like they did in 2.x. Labels changed or translated since the update are kept.
• WPML and Polylang: the labels and dropdown options of the Fields Manager fields, and the labels of "other" social media links, can be translated in String Translation ( WPML ) or Strings translations ( Polylang ). Developers: wpsl_get_custom_field_label() returns a field label in the current language.
• Searching the locations in the admin stopped at the first address field with a match, so a city name that also appears in a street address missed the locations in that city. It now searches the address, city, state, zip and country together.
• Importing settings without choosing a file showed a PHP warning on PHP 8. It now only asks you to select a file.
• A location without a name could show "undefined" in a Mapbox map popup. The name stays empty now.
• Developers: Location_Utils::get_duplicate_latlng_ids() grouped locations by latitude only, and failed on MySQL with ONLY_FULL_GROUP_BY. It now groups by latitude and longitude.

• "Draw the search radius circle?" option ( Map settings ), with a color setting and the 'wpslRadiusCircleStyle' JS filter.
• "Show locations at the same address as one marker?" option ( Markers settings ). Two or more locations at the same address share one marker. Its info window shows them one at a time, or as a list when there are more than five.
• Detects outdated cached scripts after an update, with an admin notice, a check on the Home page and an "Outdated cached files" tool. See how to clear the cache.
• "Enable the social media group?" option ( Editor settings ). Social media links per location ( X, YouTube, Instagram, Facebook, LinkedIn, TikTok, Pinterest, WhatsApp, Yelp, Tripadvisor or any other link ), shown as brand icons in the search results, the info windows and on the location pages. Developers: the {{wpsl_social_links}} template tag and a social attribute on [wpsl_address]. If the icons don't show up after turning it on, clear your page or server cache.
• Quick setup on the Home page: the six main choices ( search method, countries, auto-locate, location pages, layout and search filters ), each saved as soon as it's picked. It's also the last step of the setup wizard. On updated sites it starts hidden.
• Developers: the 'wpsl_full_search_region_meta_keys' and 'wpsl_status_report_server_details' filters. Changed
• Featured locations sort first.
• Distances under 1 km / 0.1 mi show in meters / feet, via a new 'distance_short' value.
• Fills in missing country codes without geocoding.
• The deactivation survey accepts an email address and longer error messages. Its technical details no longer check the Google API key live.
• A redesigned setup wizard, with a fourth "Your Locator" step for the Quick setup choices.
• Store categories are managed by users who can edit all locations ( administrators and the Store Locator Manager role ), instead of everyone with the manage_categories capability.
• Password-protected locations are left out of the search results, as they already were from [wpsl_map], [wpsl_address] and [wpsl_hours].
• On multisite, the server details in the status report are only shown to network administrators. Fixed
• Country-restricted searches now include locations without a country code.
• Whole-country or -state searches now return all locations, not just the max.
• Google Maps: fixed a blank map behind consent tools, country lists in the 'wpsl_geocode_components' filter, and markers hiding behind others at the same address.
• Featured locations are no longer dropped when more results match than the max.
• Long category names wrap in the dropdown and search results.
• Fixed setting combinations: name search with "Load locations on page load", auto-locate with "Load locations on page load", and "Ignore the default start location" with "Use my current location".
• A single name-search result now zooms in.
• [wpsl_map] without locations loads at its configured center ( OpenStreetMap, Stadia ).
• Locator styles print with the shortcode, so cache and optimization plugins ( LiteSpeed, Cloudflare Rocket Loader ) no longer break them.
• "Only show the category filter?" correctly hides the search field and lists a picked category's locations.
• Picking a country or state from the address suggestions lists all its locations ( Google Maps, Mapbox, Stadia ).
• Mapbox: whole-country or -state searches work with the Geocoding v6 response.
• Stadia Maps: address suggestions include countries and regions.
• Mapbox: the active marker shows on top, and clustered markers no longer bounce on hover.
• Changing the restricted countries now clears the cached page load results, which kept showing the old locations for up to a day.
• The bulk geocode tool only returns the names of locations the user can edit.
• Google Maps: the start marker's info window and the shared-marker list escape names and addresses.

• A "Please adjust your search" field on the Labels settings.
• Featured stores: enable "Show first in results?" in the store editor to show a store above the other results. Set their colors on the Appearance page.
• Category colors, shown as a dot in the category filter and in a new "Color" column on the Categories page.
• An alert on the Home page when a Permissions-Policy header on the site blocks geolocation, which breaks auto-locate and the "Use my current location" button.
• A "Show categories?" option on the Appearance page to list the categories of a store below its address in the search results.
• A "Hide the search results list?" option, or results_list="false" for [wpsl], to only show the search bar and the map.
• A "Hide the start marker?" option on the Markers settings.
• A "Show the store thumbnail in the info window?" option on the User Experience settings.
• A 'directions' attribute for [wpsl] to hide the "Directions" link: [wpsl directions="false"].
• An option under Tools to hide the WPSL admin bar menu, or to only show it when there is an alert.
• Link to a search with ?wpsl_address=Amsterdam, or ?wpsl_name= for the name search. Both are read in the browser, so they also work with page caching. 'wpsl_category' works as an alias of 'wpsl_cat'.
• wpsl_create_meta_filter() dropdowns show the option labels of the Fields Manager, and start with an "Any" option. New 'labels' and 'empty_label' arguments. Changed
• The system status report shows the search method, whether the API keys are saved and valid, and the active alerts.
• The deactivation survey asks what went wrong, with an optional checkbox to include the system status report.
• A [wpsl] shortcode with a 'city', 'state' or 'country' restriction no longer auto-locates the visitor. A 'start_location' in the shortcode now also wins over the auto-locate setting, unless auto_locate="true" is in the same shortcode.
• The Appearance preview shows example categories instead of the categories of the site.
• The draft and pending counts on the Locations tile of the Home page are stacked instead of side by side.
• The markup of wpsl_create_meta_filter() changed, and its value is sent as restrictions[{field}]. Register the field with the 'wpsl_restriction_meta_fields' filter, or set the new 'name' argument.
• On Google Maps, a store page or [wpsl_map] with a single store now zooms in on that store, up to the "max auto zoom level", the same as on the other map services. It used to open at the start zoom level. A 'zoom' attribute still sets the zoom level. Fixed
• A stray number below a store when "Hide the opening hours" was enabled and another script defined a global hours variable.
• The destination marker of a route didn't switch to the active marker when clicked.
• A 'gmp-click' console warning in the Appearance preview with Google Maps Advanced Markers.
• An empty Google map when a theme or plugin loaded an older jQuery version, such as 1.11.
• A JavaScript error on an empty ( null ) geocoding or AJAX response.
• The underline of the expandable opening hours status ran past the arrow in some themes.
• A cache-poisoning issue in the start location of [wpsl]: "London, Ontario" in one shortcode changed the start location of every shortcode set to "London".
• Fixed an authenticated stored XSS in the template attribute of [wpsl], and in the marker hover effect on OpenStreetMap through the store marker fields. Found by Intrudify.
• The marker popup showed the country, and passed 'listing' instead of 'info_window' to the 'wpsl_store_header_template' filter.
• A PHP 8 fatal error when saving a store, if Google returned an address component without a 'types' field. Stores were also wrongly rejected by "restrict country" when Google left out the short country code.
• In the classic editor, saving a store never showed the geocoding warning or error, such as an imprecise address or a store set to pending because its address could not be found.
• [wpsl_hours] showed the opening hours of unpublished stores.
• [wpsl_map], [wpsl_address] and [wpsl_hours] showed the details of password-protected stores.
• Empty parts such as ", ," in the Google directions link. [wpsl_address] now includes the zip code and follows the 'wpsl_force_direction_coordinates' filter.
• The fax number was a clickable tel: link.
• HTML tables in a store description, custom field or custom template were hidden.
• A PHP warning for an unknown category in the 'wpsl_cat' URL parameter.
• Quick Edit on a category removed its markers.
• "Location(s) of contact details" and "Location(s) of opening hours" couldn't be emptied. With nothing selected, they went back to the search results after saving. The upgrade from 2.x also turned them on in the search results when they were off in 2.x.
• With icons enabled, the "More details" and "Directions" links didn't line up with the address text.
• An empty "More details" label pushed the "Directions" link out of line with the address text.
• Custom markers looked too small in the marker dropdown of the store editor and the shortcode generator.
• The shortcode generator always added auto_locate="false", and its dialog could open out of view.
• The offer to ignore the search radius showed for country, state and filter-only searches, which don't use a radius.
• The "Geocode API Response" and "Convert 1.x opening hours" dialogs could open out of view.
• With OpenStreetMap, a search for a whole country or state only returned the locations within the search radius.
• Declining the location prompt after clicking "Use my current location" showed no message when the auto-locate attempt on page load had already timed out. The button then kept flashing and the Search button stayed disabled.
• The Apply button in the filter panel ran into the scrollbar when the list of filters scrolled.
• The marker popup on the store pages and of [wpsl_map] had different spacing per map service: no space between the address and the contact details on Google Maps and Mapbox, and extra space on OpenStreetMap and Stadia.
• With the styled buttons enabled, the marker popup still showed its "Directions" and "More details" links while the route was already showing.
• The label of a wpsl_create_meta_filter() dropdown was aligned to the top of the dropdown instead of its middle. On smaller screens the dropdown also sat higher than the category dropdown next to it, and on phones it wasn't full width.

• Added a content hash to lazy-loaded JS modules to prevent browsers, hosts or CDNs from serving an older copy and breaking the map or settings page.

• Fatal error "Service not found: plugin_alerts" on admin and AJAX requests when another plugin, such as MainWP Child, logs the user in during init.

• Prevent a fatal error by checking that is_plugin_active is available before calling it.
• wpsl_create_meta_filter() now calls the correct service.
• The Dimensions tab now shows the height fields of the active template.
• Results list no longer overflows its container with a custom height, plus other styling fixes.
• Custom CSS for the v2 dropdowns and search button overrides the v3 styles again.
• The radius and results dropdowns no longer disappear when "Only show the category filter?" was saved after the category filter was disabled.
• Custom v2 code reading the height from $wpsl_settings now gets the active template's height, instead of always 450.
• After upgrading from v2, an alert explains why the Google Maps server key check failed, and the Home step reads "Fix your Google Maps API key".
• Clearer instructions when Google blocks the server key due to IP/API restrictions or a disabled Geocoding API.
• The v2 "Hide the scrollbar?" option is back as "Show all results" in the horizontal template's Results height setting (Appearance → Dimensions).
• Theme CSS for multi-column search results works again; a single column renders as a normal list, as in v2.
• The Appearance preview now resizes the category dropdown to match search field width changes. Changed
• Optimized the responsive CSS.
• The vertical template's search field and filters use the search results' font size instead of the theme's body size (theme CSS can still override it).
• With "Overwrite theme styles" off, theme colors take priority over plugin defaults again, as in 2.x.
• With 2-3 result columns, the column count now follows the results list width, staying at least 260px wide per column.

• Added support for Mapbox, Stadia and OpenStreetMap (Leaflet)
• A new modern theme
• Support for name searches
• Create your own markers in the Marker Studio
• Draw polygons, circles, rectangles and lines on the map
• Fields manager that allows you to manage custom data fields
• Appearance editor that allows you to customize the theme / CTA buttons / active map styles (custom colors, icons, etc.)
• Template section editor that allows you to customize the code of different template sections
• Show the current open / closed status
• Make the current opening status expandable
• Select different template locations where the contact details, opening hours and post content are displayed
• Option to select an active store marker
• Option to set a category marker
• New cluster marker styles for Google Maps
• Added the option to show the number of returned results
• Option to define the search results order (ascending / descending) and sort by (address / id / distance / city / state / country)
• Optionally only show the category filter
• Default category filter selection
• If the search input is a country or state, then return all results
• If no results are found, then show the nearest location ignoring the used search radius
• Option to exclude locations from nearby countries in the search results (a search for a border town no longer shows locations across the border, even if they fall inside the search radius)
• Select the returned geolocation address format (zip, city/town, full address)
• Choose to run the geolocation attempt on page load or when the user clicks the auto-locate button
• Set the placeholder for the search field
• Option to open the info window by hovering over the corresponding marker
• Clicking on the address details in the search results opens the info window on the map
• Option to set a store permanently or temporarily closed (optionally automatically reopen)
• Option to set the opening hours to a custom text, and a "special hours" input field
• Built-in GDPR support
• An Alerts section on the settings page that shows compatibility warnings and other relevant messages
• Data management tool that allows you to delete all locations / categories and reset the plugin to default settings
• Import / export settings tool
• When "Add New Store" is clicked and no valid API key exists for Google Maps or Mapbox, a warning is shown that an API key is required, unless the coordinates are entered manually
• New shortcode options for [wpsl]: 'exclude_category', 'category_parent_id', 'category_filter', 'radius_filter', 'results_filter', 'map_style', 'map_id', 'active_marker', 'marker_clusters', 'shapes', 'city', 'state', 'country' and 'distance_unit'
• New shortcode options for [wpsl_map]: 'map_id', 'store_marker', 'active_marker', 'marker_clusters', 'shapes', 'city', 'state' and 'country'
• New 'current_status' and 'expand_status' attributes for the [wpsl_hours] shortcode, so the open / closed status and its expandable week can be set per shortcode instead of only globally
• New 'contact_details' attribute for the [wpsl_address] shortcode. Shows or hides the Phone/Fax/Email/Url block in one go, so a single shortcode can disagree with the contact details location setting without needing four attributes. The individual 'phone', 'fax', 'email' and 'url' attributes still win where they are named.
• New 'bold_contact_details' attribute for the [wpsl_address] shortcode. Wraps the Phone/Fax/Email/Url labels in <strong> (default true) so single store pages match the search results list. Set to false to restore the v2 unbolded output, or override via the 'wpsl_address_shortcode_defaults' filter.
• Added per-label show/hide toggles for the search-bar labels, so you can hide a label on the front-end without losing its text or the field itself.
• A wpsl_create_meta_filter() function allowing developers to create custom dropdowns / checkbox lists based on the passed custom meta key.
• A 'wpsl_sortable_columns' filter to make custom columns sortable in the admin area
• A 'wpsl_skip_required_check' filter to disable all required checks
• A 'wpsl_force_direction_coordinates' filter to use the coordinates instead of the address details as the destination in the Google Maps direction links Changed
• Modernized the decade-old codebase
• Migrated to v4 of the Google Geocoding API
• Migrated from the DirectionsService to the new Google Routes API, which has to be enabled in your Google Cloud project
• New users now go through an onboarding process
• Overall improved accessibility / keyboard navigation
• Improved support for RTL languages
• The data for the returned locations is now loaded in a single batch instead of one location at a time. The post data, custom fields, categories and featured images are all primed up front, which keeps the number of database queries flat when the search results or a [wpsl_map] contain many locations.
• The settings are read in one query per request instead of one per option group, and only the two groups needed on every page load are autoloaded.
• The CSV Manager, Statistics and Search Widget add-ons require version 2.0 or later. Older versions are automatically disabled until you update them.
• The new vertical theme's store locator container defaults to 450px high
• The default markers are now SVG files instead of PNG. PNG is still supported.
• Extended the admin search with support for zip, city, state and country searches
• Google Maps API key related errors are captured and shown to the user, explaining how to fix them
• Check for the partial match param in the Geocode API response for Google Maps, and warn the user if this happens
• Renamed the "below_map" (Show the store list below the map) template to "horizontal"
• The 'more info' section now always shows when it's enabled, so it's no longer required to have contact details filled out
• The start day of the week for the hours respects the WordPress settings
• If the label tag is left empty on the settings page, then don't render the label tag in the search bar
• Set the correct alt text on the preload image
• The tabs in the admin area fail gracefully, so they remain accessible if a JS error occurs
• The shortcode warning that shows up when it's used outside of a store page is now only shown to logged-in users
• Make the directions use the start / location markers instead of the default ones
• If the auto location option is enabled but no SSL is available, the exclamation mark next to it appears red, with popup text explaining the issue
• The 'zoom_controls' attribute was removed from the [wpsl_map] shortcode. Zoom controls now follow the map provider's default behaviour.
• The 'phone', 'fax', 'email' and 'url' attributes of the [wpsl_address] shortcode now follow the contact details location setting, instead of always being enabled.
• Removed support for the InfoBox library to style the pop-ups (no updates for many years). Popups are now styled according to the map provider's default styles.