Skip to main content
Store selection sidebar settings panel in the theme editor

Theme Editor > Store selection sidebar

The Store selection sidebar panel configures the slide-out sidebar that appears on storefronts with multiple locations. Customers use this sidebar to browse stores, read descriptions, and select a pickup location.
The top bar store selector appears only on storefronts connected to more than one active store location. A storefront with a single active location selects it for every customer, so the top bar has nothing to offer.

Settings

How store selection works

Store selection lets customers choose which Location they order from. It appears in two places: a button in the top bar and a dedicated selector on the cart page. Both open the same configurable sidebar.

Top bar

The storefront top bar renders a store selector button on the right side. Clicking it opens the store selection sidebar where customers browse all active locations and pick one. The top bar is visible on all storefront pages except checkout and link pages. Once a customer selects a store, the button displays the store name. The selection persists across page navigations and browser sessions.

Cart page

The cart page carries its own store selector: a card above the cart contents whose title names the step the customer has left to take. It reads “Select a pickup store” while no store is chosen, and “Pick-up from {store name}” once one is. A store is picked for the customer when exactly one store can fulfill everything in the cart. The two automatic selections narrow from different directions. The site narrows to one store when the storefront has only one; the cart narrows to the stores that can fulfill what the customer put in it. The line under the card title reports availability:
  • “Available in N stores”. N stores can fulfill the cart for the selected dates, and the customer has not chosen one yet.
  • “Not available in any store”. No store can fulfill the entire cart.
  • “Cart available” or “Cart unavailable”. The verdict for the chosen store, once there is one. The same two labels mark every store’s row in the sidebar.
This check considers both eligibility and real-time stock levels. A store can be eligible for a listing and still read as unavailable when it lacks stock for the selected dates or quantities.

Checking out before a store is chosen

Checkout stays enabled while no store is chosen. Pressing it opens the store selection sidebar, outlines the selector card, and the page reads “Select a pickup store to continue.” The store the customer picks there carries them straight on to checkout, with no second press of the button. Two other messages appear in the same place. “Selection is not valid. Please update your cart.” is the one case that disables checkout, and the customer has to change the cart to clear it. “We couldn’t check availability. Please try again.” leaves checkout enabled, and pressing it runs the check again. The chosen store determines which checkout configuration is used.

What store selection controls

Selecting a store scopes the customer’s experience: When a customer opens the store selector, they see a list of all active locations. Each store entry shows the store’s name, address, and today’s opening hours. These fields are fixed and not configurable. The image, description, phone, email, and opening-hours toggles apply to the individual Store page, not to the sidebar. The sidebar title and description let you add context above the store list, such as “Choose your nearest location” or instructions for selecting a pickup point. Both the title and description are translatable. Manage translations under Settings → Translations & Languages.

Locations

Location settings including fulfillment rules and sales channel toggles.

Availability

How location selection narrows availability from eligibility to real stock.

Stores page

The stores directory page listing all locations.

Checkouts

Per-location checkout assignment and configuration.