Child pages
  • Store Locator - Magento 2

Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.



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.

Let's 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 in the example above) to your store URL:

No Format

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 default at the Store Locator page;
  • Default Search Measurement - miles/kilometers.
titleClick 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 available for customers 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.

Importing Locations via CSV 


In case if you want to add multiple store locations at once, you can take advantage of the provided import functionality. This functionality is integrated into the native Magento Data Import section located at: System > Data Transfer > Import.

The Entity Type section contains the Aheadworks Store Locator - Locations option, which, if selected, enables an import configuration form with two configuration blocks, Import Behavior and File to Import.

System > Data Transfer > Import > Aheadworks Store Locator - Locations

Import Behavior

The Import Behavior set contains the following options:

  • Import Behavior. The drop-down contains two options: Add Locations and Delete Locations and Add Locations. If the first option is selected, the functionality adds new locations to existing ones. If the second option is chosen, the module will replace previous locations with the new ones;
  • Stop on Error / Skip Error Entries. You can choose either to stop the import process each time an error is detected or skip errors and continue importing;
  • Allowed Errors Count. Defines the number of errors to cease the import process;
  • Field Separator. The symbol that separates fields;
  • Multiple Value Separator. The symbol that separates multiple values;
  • Fields Enclosure. Tick the button in case if you upload files containing spreadsheets.

File to Import

The File to Import configuration section contains the following options:

  • Select File to Import. The option allows you to select a CSV file to be imported.

Please make sure that the file doesn't exceed the limit of 2 Mb.

  • Images File Directory. Using this option you can set a path to images in the imported file. For example, if the images are stored in the store_root/pub/media/import/aw folder, the path is going to be aw/image.png.


UI Button
titleProduct Page