Product List Settings

#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, 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

1. Go to Template > Widgets.
2. Open Ecommerce Product List.
3. In the saved settings area, click Add Setting.
4. Enter a clear Setting Name.
5. Choose the display, sorting, limit, and filter options.
6. 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:

1. Choose a Default Setting if one is not already selected.
2. Fill in any placement-specific fields that remain visible, such as category, product group, or brand.
3. 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.

#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.

#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