Skip to main content

Installation

This guide walks you through installing Store Locator Map: SE on your Shopify store and completing the initial setup.

Prerequisites​

Before you begin, make sure you have the following:

  • An active Shopify store on any plan (Basic, Shopify, Advanced, or Plus).
  • A Google Maps API key with the Maps JavaScript API and Geocoding API enabled. If you do not have one yet, see Google's guide to getting an API key.

Step 1: Install from the Shopify App Store​

  1. Visit the Store Locator Map: SE listing on the Shopify App Store.
  2. Click Add app.
  3. Review the requested permissions and click Install app.

Permissions​

During installation, the app requests the following permissions:

PermissionPurpose
Read and write theme filesRequired to embed the store locator widget into your theme.
Read store informationUsed to pre-configure regional defaults such as currency and locale.

These permissions are the minimum required for the app to function. No customer or order data is accessed.

Step 2: Complete the Setup Wizard​

After installation, the setup wizard guides you through three configuration steps:

1. Add Your Google Maps API Key​

Enter your Google Maps API key in the provided field. The app validates the key to confirm that the required APIs are enabled. If validation fails, check that both the Maps JavaScript API and Geocoding API are active in your Google Cloud Console.

2. Add Your First Store Location​

Provide the details for at least one store location:

  • Store name
  • Street address, city, state/province, and postal code
  • Phone number (optional)
  • Business hours (optional)

The app geocodes the address automatically to place a marker on the map.

3. Embed the Widget on a Page​

Choose how to add the store locator to your storefront:

  • Theme Editor (recommended) -- Add the Store Locator block to any page section via the Shopify theme editor. This approach requires no code changes.
  • Manual embed -- Copy the provided HTML snippet and paste it into a custom page template or Liquid file.

Step 3: Verify the Installation​

Navigate to the page where you embedded the widget. Confirm that the map loads, your store marker is visible, and the search functionality returns expected results.

Next Steps​

  • Quick Start -- Walk through a complete setup in five minutes.