Magento set mode to list in catalog search

Magento set mode to list in catalog search

August 31, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Magento set mode to list in catalog search

Display Magento Products in List Mode by Default

As an e-commerce merchant using Magento, you might want to control how your product search results are displayed. By default, Magento shows the products in grid mode. However, for a better user experience, especially on mobile devices, displaying products in list mode could be more intuitive.

In this post, we’ll guide you through setting up your catalog search to display products in list mode by default.

Understanding Product Display Modes

Magento offers two primary product display modes:

  1. Grid Mode: This is the default view where products are shown as thumbnails with a fixed number of columns.
  2. List Mode: In this mode, each product occupies a single line with more detailed information displayed.

Setting Up List Mode by Default

To achieve our goal, we need to make changes to the search result template and adjust some configuration settings.

Step 1: Update the Search Result Template

The first step is to update the XML layout for the search result page. Open your app/design/frontend/<your-theme>/layout/catalogsearch.xml file (create it if not exists) and add the following:

<reference name="catalogsearch_result">
    <action method="setMode" mode="list"/>
</reference>

Ensure to replace <your-theme> with your current theme’s code.

This setMode action changes the display mode of the product list on the search result page.

Step 2: Compile Your Layout

After making this change, you need to compile your layout for Magento to recognize and apply the new settings. You can do this via SSH:

php bin/magento setup:static-content:deploy

Or, if you’re using a Magento Commerce license, run this command instead:

bin/magento deploy:mode:set production

Testing Your Changes

Refresh your search page after implementing these changes. You should now see your products displayed in list mode by default.

Additional Considerations

Overriding the Template

If you want to customize the look and feel of the list view, you can override the template file vendor/magento/module-catalog/view/frontend/templates/product/list.phtml. Remember to keep your changes separate from the core files using a custom theme or module.

Controlling Display Mode on Other Pages

The method described above applies only to the search result page. If you want to change the display mode for other product listing pages like category view, you’ll need to adjust the layout accordingly in the catalog_category_view.xml file located under your theme’s layout folder.

Conclusion

Displaying products in list mode can significantly enhance user experience on mobile devices and improve product visibility. By following this guide, you now know how to set up your Magento store to display search results in list mode by default with minimal effort.

Remember that customizing the look of your list view might require additional CSS styling. You can find more information about theming and responsive design in our detailed tutorial on Magento theme development.

If you have any other questions or need further assistance with Magento customizations, feel free to reach out to us at LaravelCompany.

Happy coding!

Catalog Themes Admin Configuration

Our network