You are browsing upcoming documentation for version 6.1 of OroCommerce, scheduled for release in 2025. Read the documentation for version 6.0 (the latest LTS version) to get up-to-date information.

See our Release Process documentation for more information on the currently supported and upcoming releases.


OroCatalogBundle defines the master catalog and the categories that are aimed at structuring products in OroCommerce.

The bundle provides the ability to manage categories and assign products to them.

Default Product Options 

The Default Product Options section is displayed on the create or edit pages of a particular master catalog category. The section contains the Unit of Quantity field that is shown by default in the product details page in the storefront, and the Precision field for the quantity that a user may order or add into the shopping list.

If both the unit of quantity and precision are specified, then all new products in this category will have these values preselected during creation.

Performance notes 

The section provides notes about improving performance of catalogs in large datasets.

Catalog Menu Caching 

The category tree is cached for complex menus when the oro_fallback_localization_val table has a great number of records. You can enable or disable the cache on demand.

You can control the default lifetime of cache in the Resources/config/layout.yml file. This value is set in seconds. So when configuring

     - [setCache, ['@oro_catalog.layout.data_provider.category.cache', 3600]]

you set the 3600 instead of the 1h cache for a category menu.

The 0 parameter set as a default value for cache lifetime means that the cache saving time is unlimited. It becomes invalidated once a category is modified.