1.Getting Started #

WP Multi Store Locator is a WordPress plugin which provides numerous functionalities. If you are running some online Store and want some smart search functionality with respect to location. It also gives the ability to admin in the back-end to manage their Stores, Categories and Sales Manager for the respective franchise.

It is a complete package with lots of features like Search Store, Nearby Store Functionality, Multiple Templates Support, Can manage Snazzy Maps Styles, Can manage Store Tags, User can use shortcode to display search map anywhere in page or post, Search stores by Region and much more.

2.Installation Guide Free Version #


For Free Version Visit following URL:

  • Extract the zip archive
  • Upload the Store Locator plugin folder to the /wp-content/plugins/directory

OR Open your WordPress site and search for “WP Multi Store Locator” for WordPress by “wpexpertsio” then click on install and choose Activate as shown in screenshot.


3.Admin Highlights #

  • Can manage Stores.
  • Can manage Snazzy Maps Styles.
  • Can manage Multiple Maps By Categories.
  • Can manage Sale Managers of their added Stores.
  • Can manage Store Categories.
  • Can manage Store Tags.
  • Can add shortcode [ wp_multi_store_locator_map id=1 ] to show Store Locator.
  • Can manage Custom Markers.
  • Measure the distances in either km or miles.
  • Option to change placeholder for search fields.
  • Add your Customer Marker Icon.
  • Search Toggle Disable / Enable option.
  • You can customize the content of the info window by adding HTML if you need. Also, you can use the below variables in the content.
  • User can manage Map Settings like Show map on frontend, Map Width, Map Height, Map Type, Search Unit, * Search radius options, Enable Search.
  • With categories,Enable Search with Tags, Show street view control, Show map type control, Zoom by scroll on map, Marker Clusterer, Cluster Size, User Marker, and more.
  • Generate a directory based on the store locations.
  • User can manage Category Based Markers.

4.Front-End Highlights #

  • User can search Store from their current location (SSL must be active ) and with desired location.
  • User can search Stores by selected units(km/miles).
  • User can search by Selected Store Categories.
  • User can use shortcode to display search map anywhere in page or post.
  • You can easily chagnge your Listing Positions Left or Right.
  • Edit support for Google Custom Map style.
  • Search stores by Region.
  • Click Collapse-able panel to showcase available categories/tags and available regions which can be fully customized via admin.
  • User can select where they wanted to show Search Option on front end (1) On Map Left side (2) On Map Right Side (3) Below Map

5.Google Maps API Settings #

Google Maps API:-

API key server key allows you to monitor the usage of the Google Maps Geocoding API.

As of June 22, 2016, Google Maps no longer allows requests for new projects that don’t include an API key. 

?Search in google

google map api key

5.1.Server API Key Pro #

When a server request to the Google Maps Geocoding API to convert an address into a set of latitude, longitude. This appears when a different location is made in the admin area, or when a CSV file is imported and the Latitude, longitude is not included in the CSV file data.

Click here to Create Server Key.

On the first page, select the project and click ‘Continue’.

On the screen, set the referrer to the IP deliver of your server to limit the use of the key.

Click on the ‘Create’ button, copy the shown API key, and set it in the ‘Server key’ field on the settings page in the ‘Google Maps API’ section of your wp multi-store locator.


Use an Existing Project in The Google API Console

If you have already created a project for your website in the Google API Console, make sure to enable the following Google Maps APIs on the Library > Google Maps APIs page.


  • Google Maps JavaScript API
  • Google Maps Geocoding API
  • Google Maps Directions API
  • Google Maps Distance Matrix API
  • Google Maps Elevation API
  • Google Places API Web Service

2,500 free requests per day. If you need more, then you need to enable billing.


If after setting the Server key you get a gray map on the front-end or a gray input field for the start location on the settings page, then there is a problem with the used API key. The only way to find out the exact problem is by checking the console output in your browser.

You can access the console in Firefox with ctrl+shift+k, or ctrl+shift+j in Chrome.

When you have opened the console, reload the page and check for any errors that are identified with Google Maps. The error itself, for the most part, incorporates a connection clarifying the explanation behind the error and how to settle it.

5.2.Get API Key #

To use the Google Maps JavaScript API, you must register app project on the google API Console and get a Google API key which you can add to your app.

A quick guide to getting an API Key

Step 1: Get an API key

Click the button below, which guides you through the process of registering a project in the Google API Console, activates the Google Maps JavaScript API and any related services automatically, and generates a generic, unrestricted API key.

create google map api key


Go to the Plugin Settings? Click on Initialize Tab? Paste API Key in the text box ? and click on Save Changes button.


how to get google map api key

6.General Map Setting #

General Map Setting Screen:

? Show map on the frontend

Enable the display of the map on the frontend and show the map submitted shortcode page.


? Map width and height
 Set the width and height of the wp multi-store locator to show on frontend.


? Map type for the google map location preview
Chose any one option from the four options: – 

1- Roadmap – display the default road map view.
2- satellite – display satellite images.
3- Hybrid – displays a combination of normal and satellite views.
4- Terrain – displays a normal street map based on terrain information.

? Search unit
 Set the search unit to measure the distance in kilometer or miles.

? Search radius options
 Choose search options here. the default one will be between square brackets.

? Show street view control?
 Show street control on the map in the frontend.

? Scroll to Map top after Search
Click on checkbox to enable scrolling option after search

? Show map type control?
 Enable the user to change the map type from the frontend.

? Zoom scroll on the map?
Enable/Disable zoom by the scroll on the map.

? Show map search option
Enable this option to showing search fields on front end

? Hide Fields for Search
User Can control fields for search like Get my location, Radius field, category field to showing on front end.

? Map Search Open as Default
User can select whether they wanted to open map search option or not.

? Switch to RTL
Language Supported with RTL. This Plugin can have any language that is used by the website.

? Custom map styling
You can change the map color, panel colors, text colors and many more from the administrator’s panel.

? User Marker Styling

? User marker
 This marker is a point as per user search on the map.

? Or add Custom marker URL
The custom marker upload by user as per their choice

? Store Marker
 The map uses markers to point out the stores on the map.

? Info Window Content
You can customize the content of the info window here by adding HTML if you need. Also, you can use the below variables in the content.



{address} {city}, {state} {country} {zipcode}


? Customized Map Style
You can customize the look of the map by adding styles here. You can get some styles from Snazzy Maps.

6.1.Placeholders Settings #

Placeholders Settings Screen

? Get Location Text Button
Set Get Location Text Button showing on front end.
? Enter Location Text
Insert Location Text showing on front end.
? Select Category
Insert Category you can use on front end.
? Select Tags
Select pre-defined tags showing on front end.
? Search Options Button Text
Insert Search Options Button Text showing on front end.
? Location not found text
Insert Location not found text showing on front end.

6.2.Grid Settings #

Grid Setting Screen

? Show grid on the frontend
 Show the results in the grid in the frontend.
? Maximum Number of Marker to be displayed
A Select number of stores to be displayed per page.
? Autoload results on the scroll
Enable/Disable autoload results when scrolling down.
? Displayed Columns
Select the displayed column in the grid in the frontend by order.
? Map Result Show on
User can select the display location where search result showing on front end (1) On Map Left side (2) On Map Right Side (3) Below Map
? Map Search Options Window Show on
User can select where they wanted to show Search Option on front end (1) On Map Left side (2) On Map Right Side (3) Below Map

6.3.Single Page Settings #

Single Page Settings Screen

? Link store to a single page?
Enable/Disable when clicking on store go to a single page for more details.
? Enter Unique Slug Name
User manually add any unique slug by their choice.
? Show feature image of the store??
Enable/Disable the display of feature image of the store in the inner page.
? Show map on page??
Enable/Disable showing a map in the inner page of the store.
? Displayed Columns?
Select the displayed column on the page in the frontend by order using any tag.

7.Adding a new Map #

How Add a New Map?
Go to Store Locator? Map? Add New Map

Add Map Title? Setup all fields On Add New Map Page Like Initialize Map Setup, Map Settings, Map Styles, Grid Settings

? Use global settings
Or Enable this option to use Default Settings.

8.Set up a Short Code #

Once your map is ready Go to? Maps?

Copy shortcode

Now you can place map shortcode anywhere you’d like, and it will add a specific feature to your Page, Post, or other content.

Copy this shortcode.

9.How Map Looks Like on Front-End #

wordpress store locator plugin free

10.Changelog #

Version: 2.0.0
* Added Multiple Maps By Categories.
* Added Info Window Customization.
* Added Google Maps Direction.
* Added Snazzy Maps Styles Support.
* Fixed Store Loading Issue.
* Added Custom Markers.
* Added Category Based Markers
*Added compatibility for WordPress 5.0.3
*add support for wpml
* Added new style for displaying Store Listings
* Fixed settings
* Added Translation Support by .PO .Mo files
* Fixed Grid Setting
* Fixed Map Height Issue
* Fixed Map Error on Firefox
* Fixed Conliction with WooCommerce
* Added Single Page Functionality For Your Stores
* Settings For Changing Slug For Your Single Page
* Add Support For RTL
* Add Support For WPML
* Add Support For Avada (Fusion Builder)
* Add Support For Divi Builder
* Add Support For Visual Composer
* New Style for displaying Store Listing
* Option to Change Listing Positions (Left/ Right)
* Add Counter icon on each Listing
* Custom Map Styling
* Option to Enable/ Disable Search Filter
* Search Placeholder Option
* Add Your Own Marker
* Search Toggle Disable / Enable Option
* Fixed backend issues
* Initial release
Help Guide Powered by Documentor
Suggest Edit
Scroll to Top