> ## Documentation Index
> Fetch the complete documentation index at: https://docs.digifist.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Store Locator

> Display physical store locations using interactive maps or image-based layouts with custom actions.

The Store Locator section allows merchants to display physical store locations using an interactive map or image-based layout. It supports multiple store pins, custom actions, and flexible layouts for desktop and mobile.

Store locators help customers find nearby physical locations, providing essential information like addresses, opening hours, and contact options in an intuitive, searchable format.

<img src="https://mintcdn.com/digifist/ZqxvWsyhkvY1mTKa/images/theme/release/sections/store-locator/store-locator-overview.png?fit=max&auto=format&n=ZqxvWsyhkvY1mTKa&q=85&s=3bf90d5487ecf514da67a2bf35101964" alt="Store Locator section overview" width="3280" height="2186" data-path="images/theme/release/sections/store-locator/store-locator-overview.png" />

## What this section controls

This section controls store location displays with the following capabilities:

* Google Maps integration or image-based grid layout
* Individual store pins with detailed information
* Click-to-call and directions functionality
* Customizable card backgrounds and styles
* Optional "See more" navigation card
* Desktop and mobile-specific height controls

## How the Store Locator works

The Store Locator uses a block-based system:

* Displays store locations using Google Maps or image layout
* Each store is represented by a **Pin block**
* Supports store details such as address, opening hours, contact actions
* Optionally includes a **See more card** for additional navigation
* Layout adapts for desktop and mobile devices

## Getting started

<Steps>
  <Step title="Open Theme Customizer">
    From Shopify admin, access the Theme Customizer.
  </Step>

  <Step title="Add Store Locator section">
    Add the Store Locator section to your page or template.
  </Step>

  <Step title="Add pin blocks">
    Click **Add block** and select **Pin** to add store locations.
  </Step>

  <Step title="Configure map settings">
    If using Map layout, add your Google Maps API key and adjust zoom level.
  </Step>
</Steps>

<img src="https://mintcdn.com/digifist/ZqxvWsyhkvY1mTKa/images/theme/release/sections/store-locator/store-locator-location.png?fit=max&auto=format&n=ZqxvWsyhkvY1mTKa&q=85&s=f8d92cc1eb25967b8fc29cce9cbe0760" alt="Store Locator section in Theme Customizer" width="3280" height="2186" data-path="images/theme/release/sections/store-locator/store-locator-location.png" />

## Section settings

Section settings control layout type, sizing, map behavior, and global card styles.

<Tabs>
  <Tab title="Content">
    ### Heading

    Main title of the store locator section.

    * Supports bold, italic, underline, and links

    ### Heading size

    Controls the size of the heading.

    **Available options:** S, M, L, XL
  </Tab>

  <Tab title="Layout">
    ### Section layout

    Defines how store locations are displayed.

    **Available options:**

    * **Image:** Uses store images in a grid layout
    * **Map:** Displays stores on an interactive Google Map

    <img src="https://mintcdn.com/digifist/ZqxvWsyhkvY1mTKa/images/theme/release/sections/store-locator/section-layout.png?fit=max&auto=format&n=ZqxvWsyhkvY1mTKa&q=85&s=e2f4f1dca34b89484f4776841b049504" alt="Section layout options" width="3280" height="2186" data-path="images/theme/release/sections/store-locator/section-layout.png" />

    ### Image layout columns (Desktop only)

    Controls the number of columns when **Image** layout is selected.

    **Available options:** Auto, 2, 3

    ### Height desktop

    Sets the section height on desktop devices.

    **Range:** 40vh – 80vh

    ### Set auto height

    When enabled, the section height adjusts automatically based on content.

    <Note>
      Desktop height options are disabled when this setting is active.
    </Note>

    ### Height mobile

    Sets the section height on mobile devices.

    **Range:** 40vh – 80vh
  </Tab>

  <Tab title="Map settings">
    These settings apply when **Map** layout is selected.

    ### Google Maps API key

    Required to display the Google Map.

    <Warning>
      You must create a Google Maps API key and paste it here.
    </Warning>

    ### Zoom

    Controls how close the map is to the store pins.

    **Range:** 0 – 21

    Higher values zoom in closer to the location.

    <img src="https://mintcdn.com/digifist/S9kUPjhQ5Gtf_9hS/images/theme/release/sections/store-locator/map-settings.png?fit=max&auto=format&n=S9kUPjhQ5Gtf_9hS&q=85&s=531553ae132298bb45c5a80284dc04fa" alt="Google Maps configuration" width="3280" height="2186" data-path="images/theme/release/sections/store-locator/map-settings.png" />
  </Tab>

  <Tab title="Cards settings">
    These settings affect all store cards.

    ### Card background styles

    Controls the visual appearance of store cards.

    **Available options:** Solid color, Blurred, Transparent

    <img src="https://mintcdn.com/digifist/ZqxvWsyhkvY1mTKa/images/theme/release/sections/store-locator/card-styles.png?fit=max&auto=format&n=ZqxvWsyhkvY1mTKa&q=85&s=7930f8bc56ca0be8cd2b1a41efdabc57" alt="Card background style options" width="3280" height="2186" data-path="images/theme/release/sections/store-locator/card-styles.png" />
  </Tab>
</Tabs>

## Block settings

Block settings control individual store locations and navigation cards. There are **two block types**:

* Pin (multiple allowed)
* See more card (maximum 1)

<Tabs>
  <Tab title="Pin block">
    Represents an individual store location.

    ### Store name

    Store title displayed on the card and map.

    * Rich text support (bold, italic, links)

    ### Address

    Store address information.

    * Textarea input

    ### Opening hours

    Store working hours.

    * Rich text support

    ### Store image

    Optional image representing the store.

    * Shopify image selector

    <img src="https://mintcdn.com/digifist/S9kUPjhQ5Gtf_9hS/images/theme/release/sections/store-locator/pin-basic-info.png?fit=max&auto=format&n=S9kUPjhQ5Gtf_9hS&q=85&s=bd33e4df4f2273ad39603db4cac65fba" alt="Pin block basic information" width="3280" height="2186" data-path="images/theme/release/sections/store-locator/pin-basic-info.png" />

    ## Store location

    Used to position the pin on the map.

    ### Latitude

    Latitude coordinate of the store.

    * Text input

    ### Longitude

    Longitude coordinate of the store.

    * Text input

    ### Custom tooltip text

    Text shown when hovering over the map pin.

    * Textarea input

    <Note>
      If left blank, the store name will be used.
    </Note>

    <img src="https://mintcdn.com/digifist/S9kUPjhQ5Gtf_9hS/images/theme/release/sections/store-locator/location-coordinates.png?fit=max&auto=format&n=S9kUPjhQ5Gtf_9hS&q=85&s=143e06713f8c7bda44bdba2cf268c626" alt="Store location coordinates" width="3280" height="2186" data-path="images/theme/release/sections/store-locator/location-coordinates.png" />

    ## Actions

    Interactive buttons displayed on the store card.

    ### Button style

    Controls the style of action buttons.

    **Available options:** Filled, Outlined, Default

    ### Phone button name

    Label for the phone call button.

    ### Phone

    Phone number used for click-to-call action.

    ### Directions button name

    Label for the directions button.

    ### Custom directions link

    Custom URL for directions.

    * Shopify URL input

    <Note>
      If left blank, a Google Maps directions link will be generated automatically.
    </Note>

    <img src="https://mintcdn.com/digifist/S9kUPjhQ5Gtf_9hS/images/theme/release/sections/store-locator/action-buttons.png?fit=max&auto=format&n=S9kUPjhQ5Gtf_9hS&q=85&s=c4fe153dc1518d304d71449b1e62da92" alt="Store action buttons configuration" width="3280" height="2186" data-path="images/theme/release/sections/store-locator/action-buttons.png" />
  </Tab>

  <Tab title="See more card block">
    Optional block used to direct users to a full store list or another page.

    <Warning>
      Only **one See more card** can be added per section.
    </Warning>

    ### Title

    Main title of the card.

    * Rich text support

    ### Button style

    Controls the button appearance.

    **Available options:** Filled, Outlined, Default

    ### Button label

    Text displayed on the button.

    ### Button link

    Destination URL for the button.

    ### Display search box on maps layout

    Shows a search box when **Map** layout is active.

    **Available options:** True / False

    ### Color scheme

    Controls background and text colors of the card.

    * Shopify color scheme selector

    <img src="https://mintcdn.com/digifist/S9kUPjhQ5Gtf_9hS/images/theme/release/sections/store-locator/see-more-card.png?fit=max&auto=format&n=S9kUPjhQ5Gtf_9hS&q=85&s=2e2c31f333d5e933e9efae9c5c8fced1" alt="See more card configuration" width="3280" height="2186" data-path="images/theme/release/sections/store-locator/see-more-card.png" />
  </Tab>
</Tabs>

## Best practices

* Always verify latitude and longitude values using a reliable mapping service
* Use consistent card background styles across all store locations for visual harmony
* Keep store names and addresses concise and easy to scan
* Use the See more card to link to a dedicated store page with additional locations
* Ensure Google Maps API key is active and properly configured with necessary restrictions
* Include accurate opening hours and update them for holidays or special occasions
* Test map pins on mobile devices to ensure proper touch interaction
* Use high-quality store images that represent the location accurately
* Provide both phone and directions options for better user experience

## Common use cases

* **Physical store listings** - Display retail locations for customers to visit
* **Dealer or reseller maps** - Show authorized dealers or distributors
* **Multi-location businesses** - Showcase franchise or chain locations
* **Showroom finders** - Help customers find product showrooms or experience centers

## Related guides

<Card title="Common Settings" icon="sliders" href="/themes/release/common-settings">
  Learn about common settings shared across sections
</Card>
