docs/user/storefront/product-listing-page.mdx
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:
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 displays every product in your store and is fully customizable through the Theme Editor. There are two default sections:
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.
You can add page sections above or below the product grid to feature:
For more information about adding page sections, please refer to our <u>Theme Editor</u> support article.
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.
Each taxon page includes a non-removable banner section at the top.
It automatically displays:
This ensures consistent category presentation throughout your store.
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:
For more information about adding page sections, please refer to our <u>Theme Editor</u> support article.
The Search Results page displays products matching a customer’s search query.
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.
The product grid displays all products that match the search query and is non-removable.
It automatically updates based on the user’s search term.
As with other PLPs, you can add additional sections to provide:
These additions apply only to the Search Results page.
For more information about adding page sections, please refer to our <u>Theme Editor</u> 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.