> 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/mapbox-maps.md).

# Mapbox maps

Follow this step-by-step guide to purchase and set up Mapbox map with the app.

## **1. Create a Mapbox Account**

1. Visit the [Mapbox website](https://www.mapbox.com/).
2. Click **Sign Up** and create an account using your email address.
3. Verify your email and log in to your Mapbox account.

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

## **2. Set Up a Billing Plan**

1. Once logged in, navigate to the **Billing** section from the dashboard.
2. Add a payment method to activate your account.
   * Mapbox offers a free tier with 50,000 map loads per month. Additional usage will incur charges based on the Mapbox pricing plan.
3. Review and confirm your plan details.

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

## **3. Create an API Key**

1. Go to the **Access Tokens** section from the Mapbox dashboard.
2. Click **Create a Token**.
3. Enter a name for your token (e.g., "Store Locator Key").
4. Select **Public Token** if the key will be used for general map features.
5. Under **Scopes**, select the permissions required:
   * **Map Loads**: Allows maps to load in your app.
   * **Geocoding**: Enables address search functionality.
6. Click **Create Token**. Your API key will be generated. Copy this key for later use.

## **4. Add the API Key to the** SpiceGems Store Locator **App**

1. Open the **SpiceGems Store Locator App** in your Shopify Admin.
2. Go to the **Map Provider** section.
3. Select **Mapbox** as your provider and paste the API key into the provided field.
4. Save your settings and verify the map loads correctly in the store locator.

***

## **Frequently Asked Questions**

**1. Is Mapbox free to use?**\
Mapbox offers a free tier with 50,000 map loads per month. Usage beyond this limit is charged based on their pricing plans.

**2. How can I monitor my usage?**\
Log in to your Mapbox account and navigate to the **Usage Dashboard** to track API requests and manage your plan.

**3. What happens if I exceed the free tier?**\
Additional charges will apply based on your usage. Review the Mapbox pricing to understand costs.

{% hint style="info" %}
If you need any assistance regarding the above configurations, please drop an email at **<help@spicegems.com>**
{% endhint %}