Title: WP Store Locator Author: Tijmen Smit Published: Ogwekkuminebiri (Ntenvu) 31, 2013 Last modified: Mugulansigo 14, 2026 --- Search plugins ![](https://ps.w.org/wp-store-locator/assets/banner-772x250.jpg?rev=830722) ![](https://ps.w.org/wp-store-locator/assets/icon-256x256.jpg?rev=1007784) # WP Store Locator By [Tijmen Smit](https://profiles.wordpress.org/tijmensmit/) [Download](https://downloads.wordpress.org/plugin/wp-store-locator.2.3.0.zip) * [Details](https://lug.wordpress.org/plugins/wp-store-locator/#description) * [Reviews](https://lug.wordpress.org/plugins/wp-store-locator/#reviews) * [Installation](https://lug.wordpress.org/plugins/wp-store-locator/#installation) * [Development](https://lug.wordpress.org/plugins/wp-store-locator/#developers) [Support](https://wordpress.org/support/plugin/wp-store-locator/) ## Description WP Store Locator is a powerful and easy to use location management system. You can customize the appearance of the map, and provide custom labels for entry fields. Users can filter the results by radius, and see driving directions to the nearby stores in the language that is set in the admin panel. #### Features include: * Manage an unlimited numbers of stores. * Provide extra details for stores like the phone, fax, email, url, description and opening hours. There are filters available that allow you add [custom](http://wpstorelocator.co/document/add-custom-meta-data-to-store-locations/) meta data. * Support for custom [map styles](https://snazzymaps.com/). * Choose from nine retina ready marker icons. * Show the driving distances in either km or miles. * Shortcodes that enable you to add individual opening hours, addresses or just a map with a single marker to any page. * Compatible with multilingual plugins like [WPML](https://wpml.org/plugin/wp-store-locator/) and qTranslate X. * You can drag the marker in the editor to the exact location on the map. * Show the search results either underneath the map, or next to it. * Show Google Maps in different languages, this also influences the language for the driving directions. * Show the driving directions to the stores. * Customize the max results and search radius values that users can select. * Users can filter the returned results by radius, max results or category. * Supports [marker clusters](https://developers.google.com/maps/articles/toomanymarkers?hl=en#markerclusterer). * Customize map settings like the terrain type, location of the map controls and the default zoom level. * Use the Geolocation API to find the current location of the user and show nearby stores. * Developer friendly code. It uses custom post types and includes almost 50 different [filters](https://wpstorelocator.co/documentation/filters/) that help you change the look and feel of the store locator. * GDPR – Load Google Maps only after the user agrees to it ( requires the [Borlabs Cookie](https://borlabs.io/borlabs-cookie/) plugin ). > **Documentation** > Please take a look at the store locator [documentation](https://wpstorelocator.co/documentation/) > before making a support request. * [Getting Started](https://wpstorelocator.co/documentation/getting-started/) * [Troubleshooting](https://wpstorelocator.co/documentation/troubleshooting/) * [Customisations](https://wpstorelocator.co/documentation/customisations/) * [Filters](https://wpstorelocator.co/documentation/filters/) #### Premium Add-ons **CSV Manager** The [CSV Manager](https://wpstorelocator.co/add-ons/csv-manager/) allows you to bulk import, export and update your locations using a CSV file. **Search Widget** The [Search Widget](https://wpstorelocator.co/add-ons/search-widget/) enables users to search from any of the widgetized areas in your theme for nearby store locations, and show the results on the store locator page. **Statistics** The [Statistics](https://wpstorelocator.co/add-ons/statistics/) add-on enables you to keep track of the locations users are searching for and see where there is demand for a new store. **Extenders** The [Extenders](https://www.de-baat.nl/wp-store-locator/wp-store-locator-extenders/) add-on adds the features needed by power users such as managing location based events, social media information and locations managed by other logged in users. ## Screenshots * [[ * Front-end of the plugin * [[ * The driving directions from the user location to the selected store * [[ * The ‘Store Details’ section * [[ * The plugin settings * [[ ## Blocks This plugin provides 2 blocks. * Map Display a WP Store Locator map for specific store locations by ID or category. * Store Locator Display a WP Store Locator map with search functionality. ## Installation 1. Upload the `wp-store-locator` folder to the `/wp-content/plugins/` directory 2. Activate the plugin through the ‘Plugins’ menu in WordPress 3. Create a [Google API Key](https://wpstorelocator.co/document/create-google-api-keys/) and set them on the [settings](https://wpstorelocator.co/document/configure-wp-store-locator/#google-maps-api) page. 4. Set the start point on the [settings](https://wpstorelocator.co/document/configure-wp-store-locator/#map). 5. Add your stores under ‘Store Locator’ -> Add Store 6. Add the map to a page with this shortcode: [wpsl] ## FAQ ### How do I add the store locator to a page? Add this [shortcode](https://wpstorelocator.co/document/shortcodes/) [wpsl] to the page where you want to display the store locator. ### Oops! Something went wrong You can fix this by setting the [browser](https://wpstorelocator.co/document/configure-wp-store-locator/#google-maps-api) key on the settings page. ### There are weird characters in the search results, how do I remove them? This is most likely caused by a plugin like W3 Total Cache that tried to minify the HTML output on the store locator page. You can fix this by excluding the store locator from being minified on the settings page of the caching plugin you’re using. In W3 Total Cache this is done by going to Minify -> Advanced -> Never minify the following pages, and fill in the page you don’t want to have minified. So if your store locator is used on mydomain.com/store-locator, then fill in ‘store-locator’. ### Can I use different markers for category or individual store locations? How to use custom markers is described [here](https://wpstorelocator.co/document/use-custom-markers/), you can also only use [different markers](https://wpstorelocator.co/document/use-custom-markers/) for a few locations, or just for the [categories](https://wpstorelocator.co/document/set-unique-category-markers/). ### The map doesn’t display properly. It’s either broken in half or doesn’t load at all. Make sure you have defined a start point for the map under settings -> Map Settings. ### The map doesn’t work anymore after installing the latest update If you use a caching plugin, or a service like Cloudflare, then make sure to flush the cache. ### I can’t dismiss the pop up asking me to join the mailing list, how do I fix this? There is probably a JS error in the WP Admin area that prevents the pop up from being dismissed. Try for a second to switch back to a default WP theme, disable all other plugins, and then try to dismiss the newsletter pop up again. ### Why does it show the location I searched for in the wrong country? Some location names exist in more then one country, and Google will guess which one you mean. This can be fixed by setting the correct ‘Map Region’ on the settings page -> API Settings. ### The store locator doesn’t load, it only shows the number 1? This is most likely caused by your theme using ajax navigation ( the loading of content without reloading the page ), or a conflict with another plugin. Try to disable the ajax navigation in the theme settings, or deactivate the plugin that enables it to see if that solves the problem. If you don’t use ajax navigation, but do see the number 1 it’s probably a conflict with another plugin. Try to disable the plugins one by one to see if one of them is causing a conflict. If you find a plugin or theme that causes a conflict, please report it on the [support page](https://wordpress.org/support/plugin/wp-store-locator). > You can find the full documentation [here](https://wpstorelocator.co/documentation/). ### Where do I report security bugs found in this plugin? Please report security bugs found in the source code of the WP Store Locator plugin through the [Patchstack Vulnerability Disclosure Program](https://patchstack.com/database/vdp/dd3fdc38-66c5-4e80-ae86-96da0e63f2ba). The Patchstack team will assist you with verification, CVE assignment, and notify the developers of this plugin. ## Reviews ![](https://secure.gravatar.com/avatar/9c821cd98fe131ebe9635006eac71a715e7c877a1133f339ade687b8aeeba45b? s=60&d=retro&r=g) ### 󠀁[Switched from Agile](https://wordpress.org/support/topic/switched-from-agile/)󠁿 [Chris](https://profiles.wordpress.org/marketeerland/) Mukutulansanja 21, 2026 Love this plugin, and love it’s simplistic approach. Easy to setup and get locations quickly listed and published. Switched to this one after using Agile Store Locator, which is so complicated that I hated updating it and could train anyone else to manage it. ![](https://secure.gravatar.com/avatar/6c96c0b771ec0dd19737f92bf12f282fc1fca4cde73dd21ed0b120e4d4c00a6e? s=60&d=retro&r=g) ### 󠀁[Perfect](https://wordpress.org/support/topic/perfect-10872/)󠁿 [Milimo Emmanuel](https://profiles.wordpress.org/manuell/) Ogwekkuminogumu (Museenene) 12, 2025 Got all I needed. ![](https://secure.gravatar.com/avatar/1d51f8d7cc8aef8e3afe20d5578f6540c5c8b3e79ea1869e857fd0aa0811eaf0? s=60&d=retro&r=g) ### 󠀁[Amazing Plugin and Great Support!](https://wordpress.org/support/topic/amazing-plugin-and-great-support-33/)󠁿 [praybould](https://profiles.wordpress.org/praybould/) Mukulukusa bitungotungo 31, 2025 I’ve used this plugin on 2 commercial sites and it is rock solid. When my client wanted to use this as a way to add cities with customers, but didn’t want to specify who they were or their street address. So the Directions link didn’t work. I received multiple custom snippets of code to get it right. Thank you Farroyo! ![](https://secure.gravatar.com/avatar/6a590d33b1013dfe0a1e08f28f3b84b6b0213fbaacd8c5a5edb21776c426cf26? s=60&d=retro&r=g) ### 󠀁[Default styling is poor](https://wordpress.org/support/topic/default-styling-is-poor/)󠁿 [technicalx](https://profiles.wordpress.org/technicalx/) Ogwomwenda (Mutunda) 3, 2025 1 reply It works well, but the default styling is bad. Fixed with labels, weird height input field, forced colour button text – nope, just use default html and let the theme handle it. ![](https://secure.gravatar.com/avatar/2c0c3cb598ba4f8a6ebe25d6763bb17c0f90e34715c38ad5015b35dccc01c950? s=60&d=retro&r=g) ### 󠀁[Best store locator / map out there! Stellar support!](https://wordpress.org/support/topic/best-store-locator-map-out-there-stellar-support/)󠁿 [mpeg5](https://profiles.wordpress.org/mpeg5/) Kasambula 14, 2025 Not only is this super easy to set up and the CSV extension works like a charm, the support is awesome. I had to style a few things and I was provided with a top tier solution. And the kicker: They could charge quite some money for this. But it`s so reasonable that it is almost unreal. ![](https://secure.gravatar.com/avatar/7df70981fee11d99f5f855ca81022a33a71f22d7c99bc94d8054b8d1e4a061ae? s=60&d=retro&r=g) ### 󠀁[Just awesome](https://wordpress.org/support/topic/just-awesome-347/)󠁿 [travis182](https://profiles.wordpress.org/travis182/) Sseeboaseka 27, 2025 Awesome plugin! Really easy to use. Locations can be added with an address and linked to a page or post and found on a map. Sort locations by distance using an address, city op zipcode. Just what I was looking for! Works like a charm. [ Read all 311 reviews ](https://wordpress.org/support/plugin/wp-store-locator/reviews/) ## Contributors & Developers “WP Store Locator” is open source software. The following people have contributed to this plugin. Contributors * [ Tijmen Smit ](https://profiles.wordpress.org/tijmensmit/) “WP Store Locator” has been translated into 19 locales. Thank you to [the translators](https://translate.wordpress.org/projects/wp-plugins/wp-store-locator/contributors) for their contributions. [Translate “WP Store Locator” into your language.](https://translate.wordpress.org/projects/wp-plugins/wp-store-locator) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/wp-store-locator/), check out the [SVN repository](https://plugins.svn.wordpress.org/wp-store-locator/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/wp-store-locator/) by [RSS](https://plugins.trac.wordpress.org/log/wp-store-locator/?limit=100&mode=stop_on_copy&format=rss). ## Changelog = 2.3.0 * Added: Two blocks for the [wpsl] and [wpsl_map] shortcodes * Added: Temporary notice that enables users to sign up for testing the beta version of the 3.0 update* Changed: Ensured all code follows the latest WordPress Coding Standards * Fixed: Authenticated stored XSS vulnerability for the [wpsl_map] shortcode * Fixed: Shortcode option ‘control_position’ not working in the [wpsl_map] shortcode if the option is disabled on the settings page * Fixed: Styling issues with the Geocode API Response test dialog and the hours in the admin area ## Meta * Version **2.3.0** * Last updated **1 omwezi ago** * Active installations **50akawula_ennukuta_mu_nkumi000+** * WordPress version ** 3.7 or higher ** * Tested up to **6.9.4** * Languages * [Azerbaijani](https://az.wordpress.org/plugins/wp-store-locator/), [Catalan](https://ca.wordpress.org/plugins/wp-store-locator/), [Dutch](https://nl.wordpress.org/plugins/wp-store-locator/), [English (Australia)](https://en-au.wordpress.org/plugins/wp-store-locator/), [English (New Zealand)](https://en-nz.wordpress.org/plugins/wp-store-locator/), [English (US)](https://wordpress.org/plugins/wp-store-locator/), [French (Canada)](https://fr-ca.wordpress.org/plugins/wp-store-locator/), [French (France)](https://fr.wordpress.org/plugins/wp-store-locator/), [German](https://de.wordpress.org/plugins/wp-store-locator/), [Italian](https://it.wordpress.org/plugins/wp-store-locator/), [Japanese](https://ja.wordpress.org/plugins/wp-store-locator/), [Persian](https://fa.wordpress.org/plugins/wp-store-locator/), [Portuguese (Brazil)](https://br.wordpress.org/plugins/wp-store-locator/), [Portuguese (Portugal)](https://pt.wordpress.org/plugins/wp-store-locator/), [Russian](https://ru.wordpress.org/plugins/wp-store-locator/), [Spanish (Argentina)](https://es-ar.wordpress.org/plugins/wp-store-locator/), [Spanish (Chile)](https://cl.wordpress.org/plugins/wp-store-locator/), [Spanish (Spain)](https://es.wordpress.org/plugins/wp-store-locator/), [Swedish](https://sv.wordpress.org/plugins/wp-store-locator/), ne [Ukrainian](https://uk.wordpress.org/plugins/wp-store-locator/). * [Translate into your language](https://translate.wordpress.org/projects/wp-plugins/wp-store-locator) * Tags * [directions](https://lug.wordpress.org/plugins/tags/directions/)[Google Maps](https://lug.wordpress.org/plugins/tags/google-maps/) [maps](https://lug.wordpress.org/plugins/tags/maps/)[store finder](https://lug.wordpress.org/plugins/tags/store-finder/) [Store locator](https://lug.wordpress.org/plugins/tags/store-locator/) * [Advanced View](https://lug.wordpress.org/plugins/wp-store-locator/advanced/) ## Ratings 4.8 out of 5 stars. * [ 288 5-star reviews ](https://wordpress.org/support/plugin/wp-store-locator/reviews/?filter=5) * [ 9 4-star reviews ](https://wordpress.org/support/plugin/wp-store-locator/reviews/?filter=4) * [ 3 3-star reviews ](https://wordpress.org/support/plugin/wp-store-locator/reviews/?filter=3) * [ 3 2-star reviews ](https://wordpress.org/support/plugin/wp-store-locator/reviews/?filter=2) * [ 8 1-star reviews ](https://wordpress.org/support/plugin/wp-store-locator/reviews/?filter=1) [Your review](https://wordpress.org/support/plugin/wp-store-locator/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/wp-store-locator/reviews/) ## Contributors * [ Tijmen Smit ](https://profiles.wordpress.org/tijmensmit/) ## Support Issues resolved in last two months: 1 out of 5 [View support forum](https://wordpress.org/support/plugin/wp-store-locator/)