> 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/getting-started.md).

# Getting started

## 1. Installation

* **Access the App:** Navigate to the [SpiceGems Store Locator App on the Shopify App Store](https://apps.shopify.com/easy-store-locator-2) and click "Add app" to integrate it into your Shopify store.

## 2. App Activation

* Open Store Locator App → click on Activate App Embed

<div data-full-width="false"><figure><img src="/files/Bk8A1OxUXKm3au5kxhsV" 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>

## 3. Setting Up Your Map Provider

* Click on Set up Map Provider&#x20;

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

* Select a Map Provider → By default, **Openstreet** is selected because it’s a free service.

{% hint style="info" %}
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.
{% endhint %}

<figure><img src="/files/DdMR1WwRk7CoQONrWRvf" 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)

## 4. Add Store Locations

* Click on Add Location

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

* Add location – Fill all the details (shown in the snapshot)

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

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

## 5. 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>