Product Listings

Product listings can be set to appear by default as either a list or grid. You can also determine how many products appear per page, and which attribute is used to sort the list. Each catalog page with a product list has a set of controls that can be used to sort the products, change the format of the list, sort by attribute, and advance from one page to the next.

Products Displayed as a Grid

Configure product listings

1. On the Admin sidebar, go to Stores > Settings > Configuration.

2. In the left panel, expand Catalog and choose Catalog underneath.

3. Expand the Storefront section.

   Storefront

4. Set the default List Mode to one of the following:

   • Grid Only
   • List Only
   • Grid (default) / List
   • List (default / Grid

5. For Products per Page on Grid Allowed Values, enter the number of products that you want to appear per page when shown in grid format.

   To enter a selection of values, separate each number by a comma.

6. For Products per Page on Grid Default Value, enter the default number of products to appear in the grid per page.

7. For Products per Page on List Allowed Values, enter the number of products that you want to appear per page when shown in list format.

   To enter a selection of values, separate each number by a comma.

8. For Products per page on List Default Value, enter the default number of products that appear in the list, per page.

9. Set Product Listing Sorted by to the default attribute that is initially used to sort the list.

10. To give customers the option to list all products, set Allow All Products on Page to Yes.

11. If you want to retain all pagination settings as customers browse through catalog listings, clear the Use system value checkbox. Then, set Remember Category Pagination to Yes.

    Enabling this setting ensures that the number of products displayed in a list or grid is retained as shoppers browse from one category to another. By default, this field is set to No because it uses more cache storage and can impact the way pages are indexed by search engines.

12. If using a flat catalog (not recommended), do the following:

    • To display a flat category listing of products, set Use Flat Catalog Category to Yes.

    • To display a flat product listing, set Use Flat Catalog Product to Yes.

13. If you want to allow dynamic references for media assets in category and product URLs, set Allow Dynamic Media URLs in Products and Categories to Yes.

14. When complete, click Save Config.

Page controls