# store-locator

> Shopify pickup locations on a Mapbox map, with a list filtered by a query field.

Status: Ready (Smootify 2.0)  
Add-on: Store Locator  
URL: https://www.smootify.io/docs/astro/reference/elements/store-locator  
Updated: 2026-10-21

## Where it can go

- **Anywhere** on the page.
- **Must contain** [`map`](https://www.smootify.io/docs/astro/reference/elements/map).
- **Out of place,** Smootify removes it from the page: also without data-api-key, or when the shop has no locations.

## What it requires

- The **Store Locator** extension (lite or server plan, or the extension activated in the Smootify dashboard). Without it, the element does nothing.

## Fields in the form

Each field’s `name` attribute tells Smootify what the field holds.

| Name | Field | What it does |
|---|---|---|
| `query` | `input type="text"` | The place to search for. |

## Attributes on the element

- **It reads** `data-api-key`, `data-style`, `data-zoom`, `data-initial-zoom`, `data-fit-bounds`, `data-padding`.

## Attributes inside it

| Group | Attribute name | Values |
|---|---|---|
| [Store](https://www.smootify.io/docs/astro/reference/attributes/store-locator) | `location` | 6 |
| [Store locator (condition)](https://www.smootify.io/docs/astro/reference/conditions/store-locator) | `condition` | 1 |