> For the complete documentation index, see [llms.txt](https://staylime.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://staylime.com/docs/volume-themes/advanced-features/store-selector.md).

# Store Selector

Set up Volume's Store Selector for multi-location stores: add locations, enable header integration, and show pickup availability on product cards.

<figure><img src="https://846450420-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJZYrhya1ZIeTZS4wpBJB%2Fuploads%2FqghT8awkUXszm0qAt7h1%2Fimage.png?alt=media&amp;token=30b36004-8bba-473c-8010-2b53ca21e075" alt=""><figcaption></figcaption></figure>

The **Store Selector** lets you set up multiple retail or warehouse locations and link them to your Shopify store’s official Locations. This helps customers quickly see product availability and discover useful location-specific details like operating hours, pickup options, or directions.

{% stepper %}
{% step %}

### Step 1: Set Up Shopify Locations

Before using the Store Selector, make sure your Shopify Locations are fully configured. These represent the physical places from which you fulfill orders or offer pickups.

To set them up, refer to Shopify’s official documentation: [**Shopify Locations Setup**](https://help.shopify.com/en/manual/fulfillment/setup/delivery-methods)

Once your locations are ready and live, you can start configuring the theme’s Store Selector.
{% endstep %}

{% step %}

### Step 2: Add the Store Selector Drawer

<figure><img src="https://846450420-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJZYrhya1ZIeTZS4wpBJB%2Fuploads%2F7J26q5aAxr0snp7UdFza%2Fimage.png?alt=media&amp;token=1c0a5423-d897-472e-8329-0610eed5a73a" alt=""><figcaption></figcaption></figure>

1. Scroll to the bottom of the left-side theme editor panel.
2. Find the **Overlay** section group.
3. Add the **Store selector drawer** section.

Each **Store** block inside this drawer corresponds to one Shopify **Location**.

{% hint style="success" icon="hand-pointer" %}
The **Store name** field must exactly match the name of the location in **Store settings → Locations**.
{% endhint %}

You can also optionally add:

* **Address**
* **Image**
* **Details** like business hours or additional info
  {% endstep %}

{% step %}

### Step 3: Add Store Selector to Navigation

#### Header

<figure><img src="https://846450420-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJZYrhya1ZIeTZS4wpBJB%2Fuploads%2Fq7Jdc0yLBhYo9m47pvZO%2Fimage.png?alt=media&amp;token=76168998-3811-4f18-8ecf-3d9ad6c250bb" alt=""><figcaption></figcaption></figure>

Enable the checkbox under the Store selector heading.

#### Menu Drawer

<figure><img src="https://846450420-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJZYrhya1ZIeTZS4wpBJB%2Fuploads%2FuF3eb9jNxMS7uNb9dgQi%2Fimage.png?alt=media&amp;token=ee4523ce-ba14-4e74-8009-92ca69f0dedb" alt=""><figcaption></figcaption></figure>

1. Go to the **Overlay** section group.
2. Add the **Store selector** block inside the **Menu drawer** section.
   {% endstep %}

{% step %}

### Step 4: Add Pickup Availability Widgets

#### Product Cards

<figure><img src="https://846450420-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJZYrhya1ZIeTZS4wpBJB%2Fuploads%2FdR27QI1W3p7y7JthXdPI%2Fimage.png?alt=media&amp;token=5dde2a4e-bcaa-42b0-907b-53e6cc0ca261" alt=""><figcaption></figcaption></figure>

In any section or block that displays product cards, enable the **Show pickup availability** checkbox.

#### Product Template

<figure><img src="https://846450420-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJZYrhya1ZIeTZS4wpBJB%2Fuploads%2Fz1SmGPBqjeH4P02eSyto%2Fimage.png?alt=media&amp;token=2aeae355-bacb-40c3-b01a-dd2aff6291b2" alt=""><figcaption></figcaption></figure>

Add the **Pickup availability** block inside the **Product overview** section.

#### Colors

<figure><img src="https://846450420-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJZYrhya1ZIeTZS4wpBJB%2Fuploads%2FqScERwMbk6ns4q6csdev%2Fimage.png?alt=media&amp;token=5399577f-89df-45cd-a7a2-a61a6071cf01" alt=""><figcaption></figcaption></figure>

Go to **Theme settings → Color scheme** and adjust the colors under the **Pickup availability** heading.
{% endstep %}
{% endstepper %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://staylime.com/docs/volume-themes/advanced-features/store-selector.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
