# Store locators ![](https://docs-assets.foxecom.app/pebble-theme/54c001d0-8632-4342-84ed-b7a3cc8ec95c.png) The **Store locators** section displays store locations in a grid or carousel layout. Each location can include an image, store name, contact information, and a button to help customers find or learn more about a physical store. Use this section to showcase retail locations, highlight branches or showrooms, or help customers find nearby stores on your homepage or landing pages. ## How to customize the Store locators section 1. In the theme editor (**Edit theme**), open the page where you want to display the section. 2. Click **Add section** and select **Store locators**. 3. Choose **Grid** or **Carousel** under Layout. 4. Configure the number of columns and spacing between locations. 5. Add, remove, or reorder **Locator** blocks. 6. For each Locator, customize its image, store information, and button. 7. Adjust the mobile layout, color scheme, and padding if needed. 8. Click **Save**. ## Section settings ### Layout Controls the overall width of the section and how store locations are arranged on larger screens. | Setting | Description | Options | | ------------------ | ------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------- | | **Container** | Controls the width of the section content. | **Full**: Uses the available page width.

**Fixed**: Keeps the content within the theme's fixed container width. | | **Type** | Controls how store locations are displayed. | **Grid**: Arranges locations in rows and columns.

**Carousel**: Displays locations in a horizontally navigable carousel. | | **Columns** | Sets the maximum number of store locations displayed across a row on larger screens. | **2–4 columns.** | | **Horizontal gap** | Controls the horizontal space between store locations on larger screens. | **0–100px.** | | **Row gap** | Controls the vertical space between rows of store locations. | **0–100px.**

*Available when **Type** is set to **Grid**.* |
![image](https://docs-assets.foxecom.app/pebble-theme/image_rSNIqBbO.png) ![image](https://docs-assets.foxecom.app/pebble-theme/image_NnnGwO0f.png) ### Mobile layout Controls how store locations are displayed and navigated on mobile devices. | Setting | Description | Options | | -------------------------- | --------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- | | **Enable swipe on mobile** | Allows customers to swipe horizontally through store locations on mobile devices. | **On** or **Off**. | | **Custom column width** | Allows you to manually control the width of each location card on mobile. | **On** or **Off**.

*Available when **Enable swipe on mobile** is turned **on**.* | | **Custom width** | Sets the width of each location card on mobile. | **20–90%.**

*Available when **Enable swipe on mobile** and **Custom column width** are turned **on**.* | | **Mobile columns** | Sets the number of location cards displayed per row on mobile. | **1 column** or **2 columns**.

*Available when **Custom column width** is turned **off**.* | | **Horizontal gap** | Controls the horizontal space between location cards on mobile. | **0–100px.** | | **Vertical gap** | Controls the vertical space between rows of location cards on mobile. | **0–100px.**

*Available when **Enable swipe on mobile** is turned **off**.* |
Turn on **Custom column width** and use a value below 90% if you want part of the next location card to remain visible and encourage customers to swipe. ### Appearance Controls the overall color scheme of the section. | Setting | Description | Options | | ---------------- | -------------------------------------------- | --------------------------------- | | **Color scheme** | Applies a theme color scheme to the section. | Select an available color scheme. |
### Padding Controls the vertical spacing around the section. | Setting | Description | Options | | ---------- | --------------------------------------------- | ------------ | | **Top** | Controls the space above the section content. | **0–100px.** | | **Bottom** | Controls the space below the section content. | **0–100px.** |
## Blocks The **Store locators** section uses repeatable **Locator** blocks. Each Locator represents one store location displayed in the grid or carousel. ![](https://docs-assets.foxecom.app/pebble-theme/67cf873f-c33f-4887-bb5c-35eab24db872.png) You can add, remove, and reorder Locator blocks to control which locations appear and the order in which they are displayed. ### Locator Each **Locator** block contains four built-in blocks: * **Image** — Displays a photo of the store or location. * **Heading** — Displays the store name or location title. * **Text** — Adds supporting information such as the store address, contact details, or opening hours. * **Button** — Adds a link to directions, a store page, or other location-related information. For detailed settings and customization options, see the **Locator block documentation**: Locator ## FAQs **Why are fewer store locations shown per row than the number of Columns I selected?** The **Columns** setting defines the maximum number of locations displayed across a row on larger screens. The section adjusts the number of visible columns based on the available screen width. Narrower screens may display fewer locations to keep each card readable. **Can I use a grid on desktop and a swipeable carousel on mobile?** Yes. Set **Type** to **Grid** and turn on **Enable swipe on mobile**. The locations will appear in a grid on larger screens while customers can swipe horizontally through them on mobile. **Why can't I adjust the Vertical gap on mobile?** The **Vertical gap** setting is available only when **Enable swipe on mobile** is turned off. When swipe is enabled, locations are arranged horizontally, so use **Horizontal gap** to control the spacing between cards. **Why is the Custom width setting not available on mobile?** **Custom width** requires both **Enable swipe on mobile** and **Custom column width** to be turned on. If Custom column width is disabled, the section uses the **Mobile columns** setting instead. **Can I display different store locations or change their order on mobile?** No. The same **Locator** blocks and their order are used on desktop and mobile. You can customize the layout separately for each device, but the section doesn't provide device-specific location lists or ordering. **Can customers get directions to a store directly from this section?** You can add a **Button** to each Locator that links to a map, directions page, or store-specific page. The destination is configured individually for each location.