The Product Summary List app (list-context.product-list) is an instance of the list-context interface — a set of special interfaces used to create content lists, such as a product list.

To create a product list, you must use the list-context.product-list and product-summary.shelf blocks.

This block is used to specify what variation of product-summary should be used to create the product list and the list-context.product-list you want as follows:

list-context.product-list also runs the GraphQL query that fetches the product list to allow it to receive the following props:

Prop name	Type	Description	Default value
category	string	Category ID of the listed items. For subcategories, use "/" (example: "1/2/3")	-
specificationFilters	Array({ id: String, value: String })	Specification filters of the listed items.	[]
collection	string	Filter by collection.	-
orderBy	enum	Sorting type of the items. Possible values are: '', OrderByTopSaleDESC, OrderByReleaseDateDESC, OrderByBestDiscountDESC, OrderByPriceDESC, OrderByPriceASC, OrderByNameASC, OrderByNameDESC.	OrderByTopSaleDESC
hideUnavailableItems	boolean	Hides unavailable items.	false
maxItems	number	Maximum items to be fetched.	10
skusFilter	SkusFilterEnum	Control SKUs returned for each product in the query. The fewer SKUs that need to be returned, the more efficient your shelf query will be.	"ALL_AVAILABLE"
installmentCriteria	InstallmentCriteriaEnum	Control the price that will be displayed when the price has different installment options.	"MAX_WITHOUT_INTEREST"
listName	string	Name of the list property in Google Analytics events.	``
preferredSKU	PreferredSKUEnum	Controls which SKU will be selected in the summary	"FIRST_AVAILABLE"

For SkusFilterEnum:

Name	Value	Description
First Available	FIRST_AVAILABLE	Best performance, ideal if you do not have a SKU selector on your shelf. It will return only the first available SKU for that product in your shelf query.
All Available	ALL_AVAILABLE	Performance is somewhat better; it will only return available SKUs, which is ideal if you have a SKU selector but still want better performance.
All	ALL	Returns all SKUs related to the product; the least efficient option.

For InstallmentCriteriaEnum:

Name	Value	Description
Maximum without interest	MAX_WITHOUT_INTEREST	Displays the maximum installment option with no interest.
Maximum	MAX_WITH_INTEREST	Displays the maximum installment option with or without interest.

For PreferredSKUEnum:

Name	Value	Description
First Available	FIRST_AVAILABLE	Selects the first available SKU it finds.
Last Available	LAST_AVAILABLE	Selects the last available SKU it finds.
Cheapest	PRICE_ASC	Selects the cheapest SKU in stock it finds.
Most Expensive	PRICE_DESC	Selects the most expensive available SKU it finds.

To select which SKU will take precedence over this prop, create a Product (field) specification and assign the value of the desired SKU to be initially set for each product. If the specification does not exist or the value is empty, the preferredSKU prop will be used as a fallback. For more information, see this guide.