Skip to main content

Store List widget settings

The Store List requests the paginated Stores and controls how its Store Card design is presented.

Display panel​

Choose one of four modes:

  • List (flex/grid);
  • Accordion (expand on click);
  • Grouped accordion;
  • Categories → stores (drill-down).

Select Store design (list item). This is a Store Card Design ID. Additional controls appear for the chosen mode.

Build a responsive Store Card grid​

Set Layout to Grid, then configure these controls:

  • Maximum columns is the desktop target. Set it to 5 for a five-column grid.
  • Minimum card width is the smallest useful Store Card. Set it to 240px, for example, when the selected Store Card becomes cramped below that width.
  • Incomplete row → Keep column slots keeps the selected column width when the final row has fewer Stores. Stretch cards expands those final cards across the free space.
  • Gap between results controls both horizontal and vertical spacing.

The two sizing controls work together. A grid configured for five columns with a 240px minimum displays five equal columns only when the Store List container has enough room. It automatically becomes four, three, two, and finally one column as that container narrows. This is based on the Layout container—not the visitor's full screen—so it also behaves correctly when the Store List occupies only half of a Map + List row.

Grid cards always fill their generated track. You do not need to calculate percentages or configure separate tablet/mobile column counts for the normal responsive case.

Keep every Flex Store Card the same width​

Open Layout → Card wrapper width. This controls the selectable result wrapper around the Store Card—not merely the inner Store Card design.

  • Use 100% for a stacked list where every card fills the Store List width.
  • For Row (wrap), enter a fixed value such as 320px when several equal-width cards should wrap onto each row.

This control appears only for Flex because Grid owns card width through its tracks. The inner Store Card container should normally use 100%. The wrapper setting is preserved when printing, preventing cards from shrinking to different intrinsic content widths.

Selected-store detail​

Enable Show store detail after selection to replace the list with a selected Store's detail card. Choose a separate Store detail card or reuse the list-item design, and set Back button label.

Filter drawer​

Enable Show filter drawer button, set its label, and select Filter search form. The chosen Search form renders inside the drawer and can contain any supported Search fields.

Map-only toggle​

Enable Allow map-only view to let visitors hide/show the Store List. Configure labels for Show map only and Show list, their icons, text/icon color, and background.

Scrolling​

Enable Scroll within a fixed height, set Max height from 200–1200px, and choose scrollbar/track colors. Disable it when the page should grow with all currently loaded cards.

Pagination​

Set Results per page from 1–100. Enable Show “Load more” and choose Button or Lazy load. Button mode exposes the label, typography, icon and icon position. Its appearance can be matched to the locator design with normal and hover text/background/border colors, border width, corner radius, and separate vertical and horizontal padding. Leaving an appearance field empty keeps the locator theme default. Every subsequent request must preserve all active search parameters.

Show the result count above the list​

Open Result count in the Store List settings and enable Show result count above the store list. The header is rendered before the filter/map-view toolbar and before the scrolling cards, so it remains visible while a fixed-height Store List is scrolled. Change Count label when “Number of shops” does not fit the site’s terminology, and enable Show print button to place the existing browser-print action at the opposite side of the same header.

Use this embedded option when the count belongs visually to one Store List. The separate Result count widget remains useful when the count must sit elsewhere in the Layout—for example above a complete Search + Map + Store List region.

Visible statuses​

Choose which Stores can appear: Active, Pending review, Relocated, Temporarily closed, and Permanently closed. Public locators normally include Active only. Exposing non-active statuses is an explicit Layout decision.

Empty state​

Set Empty-state text for a valid search with zero matching Stores. Request errors and loading states are handled separately and should not be disguised as “No results found.”