Store Locator

This topic applies to

Applies to

SuiteCommerce | SuiteCommerce Advanced


The Store Locator feature lets customers find physical store locations by searching your NetSuite account’s Location records and returning results within proximity of the customer’s location or any specified address. Besides locating a physical store in which to shop, the Store Locator is helpful for orders where the customer will pick up their items instead of having them shipped.


The Store Locator feature uses the Google Maps JavaScript API. For this feature to work properly on your site, you must acquire an authentication API key from Google.

With this feature enabled, customers can:

  • View store locations as a list and on an interactive map

  • View stores near their current location

  • Search for stores near a specific address, city, or zip code

  • Choose from a list of results to view information about a location, including address and store hours

  • View a complete list of all stores

  • Get directions to a particular store

Customers access this feature by clicking the Store Locator link in the header. When the Store Locator page loads, customers have the option to enable geolocation. If enabled, SCA employs the customer’s current location as the search origin point from which to find nearby stores. At any time, the shopper can enter a specific address as the search origin point.

The Store Locator feature relies on code within the Location module to perform search queries on NetSuite Location records. The StoreLocator Module extends these methods to return only specific locations based on settings you configure.


You configure your site to return stores within 60 miles of the search origin point. The origin point can be an address entered by the customer or a point based on their location. You also set up your site to show the nearest three stores if no stores exist within the specified radius.

Later, a customer searches for stores on your site, using their current location as the search origin point. StoreLocator.Model.js extends methods in Location.Model.js in the backend. These models return only store locations based on your configuration settings (returning only stores within 60 miles of the customer’s location). If no stores exist within this radius, StoreLocator.Model.js returns the nearest three stores, ordered in descending distance from the search origin point.


Currently, SuiteCommerce Advanced uses the secure domain associated with the Checkout application to display the Store Locator feature. This is largely transparent to the shopper, but the URL will reflect this.