Product List Settings
How to manage reusable display settings for ecommerce product list widgets and category product lists.
Overview
Product list settings let you control how ecommerce product lists appear across your site from one place. A setting can control layout, sorting, pagination, price display, subcategory links, and sidebar filters. Pages and categories that use the same setting update together when that setting changes.
This is especially useful for category pages. New categories can use the default product list setting automatically, so changing that one setting later can update product list behavior across category pages that reference it.
Managing Product List Settings
- Go to Template > Widgets.
- Open Ecommerce Product List.
- In the saved settings area, click Add Setting.
- Enter a clear Setting Name.
- Choose the display, sorting, limit, and filter options.
- Click Save.

Choosing the Default Setting
Use Use as default setting when you want new product list widgets to start with that setting automatically.
Only one product list setting can be the default at a time. If you mark a different setting as the default, the previous default is automatically unset.
Tip: Give the default setting a name that explains its purpose, such as "Default Category Product List" or "Standard Product Grid".
Using Settings in the Editor
When inserting an Ecommerce Product List widget in the editor:
- If there is one saved setting, turn on Use [setting name]. If there are multiple, choose a Default Setting from the dropdown. Settings appear before you type; type to find more. An existing placement referencing an unavailable setting keeps the dropdown so you can choose a replacement or clear it.
- Fill in any placement-specific fields that remain visible, such as category, product group, or brand.
- Save the widget.
Shared fields such as layout, sorting, limit, and filters are hidden once a setting is selected. This keeps each placement small and makes future updates easier.
To edit the selected shared setting, use Edit shared setting in the inherited settings panel when there is one setting, or the pencil beside Default Setting when there are multiple. The editor's warning shows the saved usage count and links to View usages and manage settings in a new tab. Saving changes affects every widget using that setting, even if you cancel inserting the current widget. Cancel within the setting editor discards its edits.
Showing a Product Group
Set Show Products By to Product Group, then pick the group in the Product Group field. Groups are managed under eCommerce > Product Groups. The number in brackets after each group is how many products that group shows on your storefront: the products its Product Filters pick that are public and not hidden, leaving out out-of-stock products while Hide Out of Stock Products is on in Store Settings. A group with no Product Filters shows every visible product.
The widget can still show fewer than that number when On Sale Only is checked or its limit is lower.
Category Pages
New ecommerce categories use the product list default setting when one exists. The category still controls which products are shown, while the saved setting controls how the product list is displayed.
Changing the saved setting later updates category pages that use that setting. This makes it possible to change category product list layout, sorting, pagination, or filters without editing each category one by one.
Turn off Show Subcategories when you do not want the automatic child-category links at the top of a category page. This is useful when the page has custom introductory content or its own category navigation.
This toggle remains available on an individual Product List widget when it uses a saved setting, so one category page can override the shared value without detaching the rest of its product list settings.
Usage Lists
Each saved setting shows where it is used. Usage rows include the content type, the item title, and a link to view the item on the site.
Use the usage list before editing a setting so you understand which pages or categories will be affected.
Deleting Settings
You cannot delete a setting while it is still used. First edit the pages or categories listed under that setting and move them to a different setting or custom configuration. Once the setting has no usages, it can be deleted.
Settings Reference
| Field | Description |
|---|---|
| Setting Name | The name shown when choosing a saved setting in the editor. |
| Use as default setting | Makes this setting selected automatically for new product list widgets. |
| Sorting | Controls the default product order, such as title A-Z or latest first. |
| Display | Controls whether products appear as a grid, list, or carousel. A carousel advances on its own and shows a pause button beside the slide dots so shoppers can stop and restart it. It also holds still while a shopper hovers over it or moves keyboard focus into it, and starts paused for shoppers whose device asks for reduced motion. |
| Product titles | Choose Two lines (the default) or Full title for grid and carousel cards. List layouts always show full titles. |
| Limit | Controls how many products appear at once and whether pagination is shown. |
| General | Controls product display options such as price visibility and whether category pages show child-category links. |
| Show Product Tags on Cards | Shows assigned tag values as badges on grid product cards by default. Product Tags must also be enabled in Store Settings. |
| Sidebar Filters | Controls whether shoppers can filter product lists by price or other available filters. |
When a shopper changes Sort by on your storefront, the page address updates to match (for example /spirits?size[0]=750-ml&sort=price-low), keeping any filters they chose. Reloading or sharing that address shows the same sorted list. Lists without a Sort by dropdown, such as carousels and lists with Hide sort options checked, keep their own order.
When Show Product Filters is enabled, the Category filter shows top-level categories containing matching products, including on shop and brand lists. On a category-scoped list, it shows that category's children instead. Counts include products assigned to descendants, and categories without matching products are omitted. Paginated lists include matches across all pages; lists without pagination use only the displayed products. Beverage lists use their beverage category filters.
Showing Full Product Titles
Open a saved Product List setting and choose Display > Product titles > Full title, then save. Every widget using that setting shows the full name, including after shoppers sort, filter, or change pages. Update each setting used by your site if all product lists should show full titles. Use as default setting selects a setting for new widgets; it does not switch existing widgets to that setting.
For a widget configured as Custom, change Product titles in that widget instead. Settings and widgets without a title-display choice use the two-line limit for grids and carousels. Saving a List layout removes the title-display choice; selecting Grid or Carousel after that save defaults to Two lines. Full titles can make cards taller. A customized card template or stylesheet may need to adopt this option separately.
Product Search, Full Search and Related Products each have their own Product titles choice. Product List shared settings do not configure them. Related Products embedded by the built-in product detail template needs an explicit full-title choice in a product detail template override.
Category Counts and Product Filters
In Ecommerce > Categories, Total Products Count counts all unarchived products assigned to the category or its child categories, including draft, hidden, and out-of-stock products. Primary and additional assignments count each product once. Beverage associations follow their type, category, and subcategory hierarchy.
Storefront Products counts products eligible for storefront lists. These counts refresh in the background; Total Products Count is calculated when the table loads. A category can have zero storefront products and still have assigned products that must be reassigned or removed before it can be archived.
Storefront category counts show public, active products that are visible in your catalog. Each product counts once, including products whose stock belongs to variations or options. Counts include additional category assignments and child categories. Beverage categories follow their beverage hierarchy. Products do not need a price to count.
When Hide Out of Stock Products is enabled in Store Settings, counts exclude products that fail the store's stock rules. When it is disabled, out-of-stock products can count, but catalog-hidden products remain excluded. Counts refresh in the background after catalog changes, so allow time for updates to finish.
On an active category, click Total Products Count to open Ecommerce > Products with the category selected and Product status set to Active. The Storefront Products link sets the ordinary filters to Active, Public and Unlisted visibility, and Availability > Not hidden. It adds In-Stock only when Hide Out of Stock Products is enabled. With Price stays unset because eligible products without a price count too. For regular categories it selects the Category filter; for beverage categories it selects the existing beverage type, category and subcategory filters instead, because storefront beverage counts use those attributes.
Availability filters the configured Pre-Order, Backorder, or Hide value, independently of inventory quantities, publication and price. Products with enabled variants match those variants' settings instead of the unused parent value; a product-level Hide takes precedence. Hide also finds products with a hidden enabled variant, even when other variants remain visible. Not hidden excludes products set to Hide and parents whose enabled variants are all set to Hide, matching catalog-list eligibility. Use the separate Stock filter for In-Stock and Out of Stock; it checks inventory quantities and the store's stock rules. Beverage filters remain available for retained beverage data or categories when Liquor Max is inactive, including categories with zero matching products. Saved beverage category or subcategory selections stay visible when their parent is missing.
Counts refresh in the background, so a recent catalog change can temporarily leave the displayed count behind its linked results. Total counts are calculated in one grouped query for the visible page and cannot be sorted. Counts on archived categories have no product links. Total links are also disabled for beverage categories whose required parent hierarchy is missing.