All Listings Page Configuration
Configure how your listings page displays products, including layout, filters, search, and card appearance.
Quick answer
Overview
The All Listings Page is where customers browse and discover products on your marketplace. Configure the layout, search functionality, filters, and how listing cards appear to create the best shopping experience for your visitors.
How to Access
/s/[your-store]/listingsPage Status
Toggle the listings page on or off. When disabled, customers cannot access the browse page.
Page Content
- Page Title: The heading displayed at the top (e.g., "Browse All Listings")
- Page Description: Optional subtitle or intro text below the title
- Page Background Color: Override the listings page background with any CSS color. Use the native color picker or type a value directly — hex (
#f5f0e6), rgb (rgb(245, 240, 230)), or named colors (beige) all work. Leave empty to fall back to the theme default. Click Reset to clear it. - Search Bar Background Color: Background of the search box and the sort dropdown above the grid. By default they use the theme default input color (off-white), which can stand out once the page background is white. Set it to
#ffffffto blend them in, or any other CSS color. Leave empty for the default.
Layout Settings
Three layouts ship out of the box. Here's what each one looks like on the storefront with the same listings:
Layout Type
Uniform grid of product cards. Clean, organized appearance ideal for most marketplaces. Configure 2, 3, or 4 columns.
Horizontal cards showing more details per listing. Good for products with longer descriptions or when comparing details is important.
Pinterest-style layout with varying card heights. Creates a dynamic, visual appearance ideal for image-focused marketplaces.
Grid Columns
When using grid layout, choose how many columns to display:
Large cards, more detail
Balanced (default)
More products visible
Items Per Page
Choose how many listings to show per page before pagination:
- 12 Items: Fast loading, more pages
- 24 Items: Balanced (default)
- 48 Items: Fewer page loads, more scrolling
Default Sort Order
Set the default sorting when customers first visit the page:
- Newest First: Most recently added listings appear first
- Oldest First: Oldest listings appear first
- Price: Low to High: Cheapest listings first
- Price: High to Low: Most expensive listings first
- Alphabetical: A-Z by title
- Nearest First: Sort by distance from visitor's location (only available when Distance Search is enabled)
Product Card Display
Choose what information appears on each listing card:
Product photo
Listing name
Current price
Who's selling
Star rating
Preview modal
Quick purchase. On a listing with stock per option (sizes, colours) it opens the listing page, where the buyer picks an option first.
Custom Field Pills
Search & Filters
Search
Enable Search
Shows a search bar allowing customers to find listings by keyword. Searches through titles, descriptions, and other text fields.
Listing Type Filter
Show Listing Type Filter
Display pill tabs at the top of the page to filter by listing type (e.g., "All", "Stays", "Experiences"). Only appears if you have multiple listing types configured.
Type-Specific Filters: When enabled, only show filters relevant to the selected listing type instead of showing all filters at once.
Filters
Enable Filters
Allow customers to narrow down listings using filter criteria. Filters automatically adapt to your listings and only show when relevant data exists.
Smart Filters
- • Text/Select filters: Show unique values with "All" and "Uncategorized" options
- • Number filters: Display as range sliders
- • Empty filters: Automatically hidden if no relevant data exists
Available Filters
Default Filters
Range slider for min/max price filtering
Filter by seller (only shows if multiple sellers exist)
Filter by category (includes "Uncategorized" option)
Custom Field Filters
Custom fields from your Listing Form can be enabled as filters. They're grouped by listing type:
- Text fields: Show as selectable dropdown options
- Number fields: Show as range sliders
- Select/Multi-select fields: Show as selectable options
- Checkbox fields: Show as Yes/No toggle
Filter Position
Filters displayed in a sidebar on the left. Classic e-commerce style, good for many filters.
Filters displayed horizontally above listings. More compact, good for fewer filters.
Filter Sections Open by Default
Choose how many filter sections start expanded, in the order you set above. The rest start collapsed and open on click, and a section with an active filter is always open. The default is the first 3. With many filters, a lower number keeps the sidebar inside the window so visitors do not have to scroll it separately.
Distance Search
Allow visitors to find listings by proximity to their location. This setting only appears when at least one listing type has location enabled.
Enable Distance Search
Adds a "Nearest First" sort option and a distance radius filter to the listings page. When a visitor selects this sort option, they'll be prompted to share their location (or enter an address manually).
When enabled, the following features become available:
- Nearest First sort: Visitors can sort listings by distance from their location
- Distance radius filter: Filter listings within 10, 25, 50, 100, or 250 km/mi
- Distance on cards: Each listing card shows how far away it is (e.g., "4 km")
- Distance unit: Choose between kilometers (km) or miles (mi)
- Manual fallback: If the browser denies location access, visitors can type an address
How It Works
Map Browse View
Give visitors a VRBO-style split-view layout with listings on the left and an interactive Google map with price pins on the right. Perfect for vacation rentals, tours, venue bookings, or any location-based marketplace. Only available when at least one listing type has location enabled.
Enable Map View
Adds a List / Map toggle next to the sort dropdown on the listings page. The toggle only appears to visitors when at least one listing has valid coordinates.
When enabled, visitors can:
- Toggle between views: Switch between the default List view and the Map view with one click
- See prices at a glance: Each listing shows as a themed price pin on the map
- Hover to highlight: Hovering a card highlights its pin (and vice versa) for easy visual matching
- Click to navigate: Click any pin or card to open the full listing detail page
- Mobile full-screen: On mobile, a "Show map" button opens a full-screen map with a card drawer on pin tap
- URL persistence: The current view is saved as
?view=mapin the URL so links can point directly to the map view
How It Works
Setup Tips
- • Enable Location on the listing types that should appear on the map (Listing Form Settings → Type Details)
- • Ask sellers to pick an address from the Google autocomplete when creating listings — plain text won't geocode
- • The List / Map toggle only appears if at least one visible listing has valid coordinates
- • Works great alongside Distance Search — you can enable both independently
Create Listing Call-to-Action
On marketplaces where any visitor can become a seller, the end of the listings grid is a natural place to ask "Have something to sell?". Turn on Show create-listing call-to-action and a band with a heading, a line of text, and a button appears under the grid (below pagination) on the All Listings page and on every listing-type tab. The same button also shows in the empty state when no listings match a search or filter, which is where it matters most on a young marketplace.
- Logged-in sellers go straight to the Create Listing form
- Visitors go to seller signup and are sent to the form once registered
- Buyer-only accounts don't see the band, so nobody lands on a page they can't use
- Custom text: heading, text, and button label are editable; leave a field empty to use the default copy in your store language
Off by default
Preview Your Page
The settings tab includes a live preview panel that reflects your changes as you make them — layout, card display, filters, and search — so you can see what each dial does without saving and hopping over to the storefront. It also reflects out-of-stock behavior, so you can see exactly how sold-out listings appear with your current settings before anything goes live.
Columns
Out-of-stock listings render just like they will on the storefront.
Preview Page Button
Best Practices
- • Start with 3 columns for a balanced grid layout
- • Enable only the filters that matter to your customers
- • Use sidebar filters for complex marketplaces with many filter options
- • Keep listing type filter enabled if you have different product categories
- • Show seller name if your marketplace emphasizes seller identity
- • Test on mobile devices - layouts adapt responsively