WooCommerce Store Locator

This documentation is for the WooCommerce Store Locator plugin.

For questions on how to install a plugin on your site check out our Installation Guide.

Getting Started With Store Locator

Once the plugin is installed and activated a Store Locator page will be added to your WordPress site using the [woocommerce_store_locator] shortcode. You can find this under Pages > Store Locator.

woocommerce store locator page

Store Locations

From here you can manage all of your store locations.

Add New

    • Select the add new button to create a new store location.
    • From here enter the title, store location information, select an image to be shown as the map icon.


woocommerce store locator settings

Google Maps Information

For the store location to appear on the map enter the location address into the address box and select Get Latitude/Longitude. This will place a map marker on the correct location based on the latitude and longitude coordinates.

*Zoom Level can also be set at this time by selecting a level from the drop-down box. 1 is far away, while 15 is very close.

store locator google maps settings


Add individual products to the location by selecting the product and then the forward arrow. To add every product available select the Add All button.

To remove a single product, click the product and select the back arrow. To remove all products select the Remove All button.

store locator add or remove products


After entering all information for the store location click the Publish button. This store will be added to the online directory and will be visible on your store locator page.


After adding the details for the store location and clicking publish a permalink for the individual location will appear below the Store Title. This permalink can be edited by clicking the edit button. If you select the permalink it will take you to the page for the individual store location. Share this link with customers to provide them with the store’s information.

store locator permalink

All Locations

The All Locations tab will display a list of all store locations in the directory.

  • View published and trashed locations
  • Bulk edit stores
  • Search for a location using the search box
  • Add New Locations


store locator all locations tab

Add New

Quickly add a new store to your directory by selecting New Location under Store Location from the WordPress dashboard.


Assign categories to store locations. This option is helpful in showing visitors what’s available at a specific location. For example, coffee shops might add a category called drive-through or indoor dining to show which locations offer the different features.

Categories can be used to identify distributors or vendors of your product. You can even show which locations are open 24 hours.

To set categories:

  • Add a name to the category in the Name box. Example: Accessories
  • Enter the slug, the URL-friendly version of the name.
  • Parent Item – hierarchy structure can be built by assigning a parent item
  • Description – this is a description of the category and it may appear to your customers depending on the theme of your site
  • Edit – bulk edit, or hover over an individual category to change the name and description
  • Count- displays the number of stores assigned to this category


store locator edit category

Categories can also be set on the individual store location by checking the desired category in the categories box.

store locator set category

In the example below the category “Shoes” has been assigned to show this location sells shoes.

store locator set category



General Settings

Google API Key- is required to use Store Locator. To find out how to get your Google API key follow the directions in the related article below.

Units– set the distance measurement with miles or kilometers

Distance- Set the distance radius for search parameters on the customer view

Search by Products- Enable this box to allow customers to search for locations based on product availability

Search by Store Name- Enable this box to allow customers to search for store location by name

Set a Default Location- Set the location of the home store

*Select Save changes to update enable changes to any of the general settings.


CSV Importer

store locator csv settings

    • Bulk Import- To import many locations at one time from your WordPress dashboard go to Tools > Import.
    • Press “WooCommerce Store Locator (CSV)”. You will be taken to an import page.
    • Press Choose File and select your import file. Press Upload file and import to start the import.
    • Upload a CSV file with all desired store locations. Use the sample CSV template available on the tab to structure your data correctly.
    • When the import is done a summary page will be shown. Review the page for any skipped rows.


Below is a sample CSV showing the correct format to upload your store locations.

store locator sample csv template

Geocode Address – Enable this feature to have Google import the longitude and latitude of each location

Upload File– Select the CSV file to upload

*Select Save Changes to enable recently imported store locations.

Map Marker Icons

WooCommerce Store Locator comes with 16 icons that can be downloaded to your media and assigned to store locations. To use the preloaded icons simply select import on the desired icon and it will be added to the media library.

*Be sure to select Save Changes after importing all of the desired icons.

store locator map markers



What the Customer Sees

This page will show a search form, a list of locations, and a map showing your locations. Customers can search for locations by entering an address or zip code and pressing Find Stores. Alternatively, customers can select a product from the dropdown list to search for the store location.

store locator map

Customers can click on a store and a popup will appear with the store details.

store details

Use Shortcode to List Stores

The shortcode takes a parameter that changes the display on the page to a list of stores. The shortcode [woocommerce_store_locator page=list] can be added to any page to show a list of stores only with no search option.

store finder shortcode




Frequently Asked Questions

  • Why is my CSV getting an error when I try to import?

The CSV needs to have the exact number of columns as shown in the template file. If there are any blank columns without titles you will receive an error when trying to import the CSV list.


Related Articles

Getting Google Maps API Key

Need help from professional WooCommerce developers?

Get a quote from Grow Development today!