Learn how to customize product listing pages in Spree Commerce.
Product Listing Pages (PLPs) display groups of products and help customers browse your catalog. In Spree, three types of pages act as PLPs and can be customized in the Theme Editor:
Shop All - a standalone page showing your entire product catalog
Taxon pages - one for each category, collection, or brand
Search Results - dynamically shows products based on the customer’s search query
Each of these pages includes a product grid section that cannot be removed, ensuring a consistent product-browsing experience across your storefront. However, you can add additional sections to shape the layout and highlight promotions, brand messaging, or featured content.
To edit a PLP, first go go to Storefront → Themes in the admin dashboard.Open your active theme, and use the page selector at the top left of the Theme Editor to choose Shop All, Taxon, or Search Results.The preview and sidebar will update based on your selection.
The Shop All page includes a title block at the top of the page body.This block is editable and removable if you prefer a minimal layout or want to replace it with your own custom section.
The product grid list all of the items in your product catalog and is non-removable.You can adjust its design settings (spacing, padding, etc.), but not delete it.
Taxon pages display products belonging to a specific category, collection, or brand. Although each taxon has its own content (name, banner, products), the layout is shared across all taxon pages.
The product grid displays all products within a given taxon, is non-removable, and appears below the taxon banner.Its design settings can be adjusted, but the core functionality remains unchanged.
You can add sections to taxon pages, but with one important note: Any section you add will appear on every taxon page.This is because all taxon pages share one layout in the Theme Editor.Therefore, avoid adding content that is specific to a single category. Instead, focus on global elements such as:
Category-specific promotional banners
Universal messaging
Brand-aligned visuals
Featured content relevant only to some taxons
For more information about adding page sections, please refer to our Theme Editor support article.
The page includes a default Search Results title block, which is both editable and removable.You can customize the text or replace it with your own page sections.
As with other PLPs, you can add additional sections to provide:
Search-related messaging
Banners to promote best sellers
Helpful visual content
Notices or suggestions
These additions apply only to the Search Results page.For more information about adding page sections, please refer to our Theme Editor support article.
After adjusting any PLP, make sure to click Publish in the top-right corner.Your changes will appear immediately on the live storefront.You can return to the Theme Editor at any time to update the layout.