After July 2021, the 2.3.x release line no longer received quality updates or user guide updates. PHP 7.3 reached end of support in December 2021, and Adobe Commerce 2.3.x reached end of support in September 2022. We strongly recommend upgrading to Adobe Commerce 2.4.x to help maintain PCI compliance.

Product Listings

This site contains archived merchant documentation for a version of Adobe Commerce and Magento Open Source that has reached end-of-support. The documentation available here is intended for historical reference only and is not maintained. The Adobe Commerce Merchant Documentation for current releases is published on the Adobe Experience League.

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

Control Description
View As Displays the products in either a grid or list format.
Sort By Changes the sort order of the list.
Show Per Page Determines how many products appear per page.
Pagination Links Navigation links to other pages.
© 2024 Adobe. All rights reserved.