Child pages
  • Store Locator - Magento 2
Skip to end of metadata
Go to start of metadata


Firefox user notice:

Please use different web browser to view this document.

Sorry for the inconvenience.

Store Locator - Magento 2

Magento 2 Store Locator is a straightforward solution enabling purchasers to find nearby physical locations of a web store by concrete address or current location distance. From the frontend area, store admins can quickly create new locations of their outlets and add the appropriate markers to Google Maps on individual store views. Additionally, they can set the map zoom, latitude, and longitude values of each created location. 

Product Page

Thank you for choosing Aheadworks!

Installing Store Locator

Command Line Installation

1. Backup your web directory and store database;

2. Download Store Locator installation package;

 3. Upload contents of the Store Locator installation package to your store root directory;

 4. Navigate to your store root folder in the SSH console of your server:

cd path_to_the_store_root_folder


php -f bin/magento module:enable Aheadworks_StoreLocator


php -f bin/magento setup:upgrade


php -f bin/magento setup:static-content:deploy

5. Flush store cache; log out from the backend and log in again.


Make sure the installation is done from under the FTP administrator account. Otherwise make sure to set 775 permissions to the store root directory after the extension is deployed.

Composer Installation

1. Log in to your customer account at and navigate to Account -> Composer access;

2. Configure your store to work with the Aheadworks composer repository:

Add composer repository to composer.json by running:

composer config repositories.aheadworks composer in the Magento installation root.

Use a key pair provided as login and pass. You can optionally save them in the global composer auth file.

 3. You can start using AW composer now.

 For extension names, navigate to Account -> Composer access.

 4. Open the root Magento directory on your server and send Composer the following command:

composer require <component-name>:<version>

Note: Use the previously copied component name and version.

 5. Make sure that Composer finished the installation without errors. Flush store cache, log out and log into the backend again.


Adding the store location

Store Locator extension comes ready for work right after the installation.

The first thing you want to do is to add the location of your store to the map. To do this, navigate to Content > Store Locator by aheadWorks:


Content > Store Locator by aheadWorks

This screen is a management center of all your store locations. Whether you want add new location, edit previously created one, or find particular location by any attribute, - this is the place you are looking for.

To add new store location click button at the top right hand corner of the screen.

  • At the General Information section of the New Location screen you are suggested to specify the store location related values such as: country, street and phone;
  • At the Google Maps Settings section of the New Location screen you can either manually specify the latitude and longitude of the store or click button to let Google Maps do it for you;
  • Once everything is done - click button.
 Click to see how the attributes will affect the store look...

That's it, you have just added your first store location.


Adjusting Store Locator settings

You have added the location of a store and definitely want to look through it. It is now high time to proceed to the Store Locator settings screen to learn how to do it.


Stores > Configuration > aheadWorks extensions > Store Locator

General settings

The extension is enabled by default after the installation, however the Extension's URL to Top Menu option that brings the Store Locator section to the frontend navigation menu is disabled.

Lets go through the settings available and what they do:

  • Enable Store Locator Page - allows enabling/disabling the extension and the Store Locator frontend page in particular;
  • Title - defines the Store Locator page title;
  • URL Key - defines the links the Store Locator page will be accessible by;
  • Google Maps API Key - this setting is only relevant for store owners running customer heavy stores with 25k+ Google Map loads per day, if you do not have this many loads you do not need to enter the Google Maps API;
  • Extension's URL to Top Menu - allows adding the Store Locator page link to the top category menu at the frontend;
  • Header CMS Block - allows displaying any CMS block at the Store Locator page.

Back to the store location you have added.

For testing purposes you can leave Extension's URL to Top Menu option disabled and access the Store Locator page directly by the URL Key specified.

Say you need to add several store locations and want to have a look at them before letting your customers access the page.

In this case you can add the store locator URL Key ('store-locations' as per example above) to your store URL:

and thus access the Store Locator page without revealing the link before your customers.

Once you have applied all the settings changes and decided on where at the Top Menu you want the Extension's URL displayed you may want to proceed to Search and SEO settings:


Stores > Configuration > aheadWorks extensions > Store Locator

Search and SEO settings

Search settings let you enhance customer's search experience:

  • Search Radius - allows defining a set of search radii available for customers;
  • Default Search Radius - defines the search radius set by defult at the Store Locator page;
  • Default Search Measurement - miles/kilometers.
 Click to see the search options...

Store Locator offers a quick navigation.

  • Customers can either manually start typing the location for Google Map suggestions to pop up;
  • Or click button and Google Maps will identify the customer's current location automatically.

Once the Current Location is set customers are suggested to select a Search Radius and Search Radius Measurement from the drop down lists, and click button.

That's it. The Store Locator will display all the stores customer has nearby.

SEO settings let you type in the Meta Keywords and Meta Description of the Store Locator page.

Once you are done with Search and SEO settings click button.

Congratulations! You have successfully set up and configured Store Location extension. Now you may want to add more store locations.

Product Page

You can always find the latest version of the software, full documentation, demos, screenshots, and reviews on
License agreement:
Contact Us:
Copyright © 2018 Aheadworks Co.

  • No labels