> For the complete documentation index, see [llms.txt](https://help.spicegems.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.spicegems.com/esl-easy-store-locator/~/changes/13/getting-started.md).

# Getting started

## Step-1: App Activation

* Open Store locator App – click on Activate App Embed

<div data-full-width="false"><figure><img src="/files/E4BNRl9w3d16ndezyIn3" alt=""><figcaption></figcaption></figure></div>

* SpiceGems Store Locator toggle is already enabled - click **Save** (Top left corner)

<figure><img src="/files/nBnlcG8objpOv0xMgiXs" alt=""><figcaption></figcaption></figure>

## Step-2: Setting Up Your Map Provider

* Click on Set up Map provider → Select a Map Provider (according to your requirements) \
  By default, **Openstreet** is selected because it’s a free service.

<figure><img src="/files/BjZ2z03J0LKs5BmDtwOZ" alt=""><figcaption></figcaption></figure>

* For [**Google Maps**](https://help.spicegems.com/esl-easy-store-locator/google-maps) and [**Map Box**](https://help.spicegems.com/esl-easy-store-locator/mapbox-maps), an API key is required. \
  You can **buy an API key** from the respective sites to integrate and utilize the map services from these providers. These map service providers have wider options for Map styling.

<figure><img src="/files/wRH7Ev5TprEg0Im5Ucbh" alt=""><figcaption></figcaption></figure>

To learn more about these Map service providers, check the below links:

[**Google Maps**](https://help.spicegems.com/esl-easy-store-locator/google-maps)\
[**Map Box**](https://help.spicegems.com/esl-easy-store-locator/mapbox-maps)

## Step-3: Add Store Locations

* Click on Add store Location → Add location – Fill all the details (shown in the snapshot)

<figure><img src="/files/TdXYf5q1tLn8wWxCU8t4" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/7bGUOX65gjOFm6mGwqyq" alt=""><figcaption></figcaption></figure>

[Click here to learn more about adding locations](/esl-easy-store-locator/~/changes/13/add-location.md)

## 4. Preview the locations in your store

The integration and configurations are done. The locations are now added to the map and visible in your store.

Click on the Preview button on the App Dashboard to access the map page.

<figure><img src="/files/2HnEJHBmNHeDzR6jS4RJ" alt=""><figcaption></figcaption></figure>