Skip over navigation

Master Catalog

This topic contains the following sections:


Master catalog is a tree structure that organizes all the products of your store under corresponding categories. A category combines the products of the same type into groups and helps enforce the unified selling strategy by configuring a special set of product options, visibility, and SEO settings that best fit the resulting product family.

Once the categories are in place, you can:

  • Add a category description and visuals.
  • Link a corresponding product or a set of products to the selected category.
  • Configure the default product options.
  • Set up an activity type and a date for its implementation.
  • Manage the category visibility.
  • Configure SEO options.

To view the Master Catalog, navigate to Products > Master Catalog in the main menu. The following page displays all the categories created under this catalog.


Create a Master Catalog Category

By default, there is only one Master Catalog in the OroCommerce application. To customize this catalog, you can add or delete a category, creating a group of products and linking it to the corresponding web catalog.

To create a master catalog category:

  1. Navigate to Products > Master Catalog.

  2. Click Create Category.

    The following page opens:

  3. In the General section, provide the following information:

    • Title — A meaningful name for the category. Click the Translations icon to provide spelling for different languages. Click the same icon again to return to the single-language view.
    • Description — A short and/or a long description of the category you are creating. Click the Translations icon to provide spelling for different languages. Click the same icon again to return to the single-language view.
    • URL Slug — A web address generated automatically once the title of the category is defined. It is used to build a human-readable URL for the product page in the storefront. Click the Translations icon to provide spelling for different languages. Click the same icon again to return to the single-language view.
    • Small Image — An image used to represent the category in the storefront.
    • Large Image — An image reserved for customisation purposes.
  1. In the Products section, select the items for the category you are creating. Use available filters to narrow down your search and speed up the selection of the necessary product items.

  2. In the Default Product Options section, configure the following settings:

    Field Description
    Unit Of Quantity A product unit that is shown by default in the product details page in the storefront. Available options are each, hour, item, kilogram, piece, set, and Parent Category. The latter is used to refer to the same product quantity unit configured for the corresponding parent category.
    Precision An acceptable value (number of digits after the decimal point) for the quantity that a user may order or add into the shopping list. Items and sets are usually whole numbers, and units like kilograms may get precision of 2 to allow buying a custom volume (e.g. 0.5 kg).
    Field Description
    Inventory Status This setting enables you to define and modify status information for the stock of the product.
    Managed Inventory

    This setting defines the method for inventory management.

    With Use category defaults, the product’s Manage Inventory inherits the setting selected for the product’s parent category. With Use system config, the product uses the system configuration setting.

    Selecting Yes enables interactive updates based on the product inventory information from the Inventory > Warehouses section. Selecting No disables connection to the inventory, and uses the static Inventory Status value.

    Highlight Low Inventory This option defines if low inventory for products is displayed in the storefront.
    Inventory Threshold A minimum quantity of the product that is treated as In stock. When a product quantity drops below this value, the product inventory status becomes Out Of Stock.
    Low Inventory Threshold The minimum stock level defined for the product. Reaching the defined level will trigger a warning message to the buyer in the storefront.
    Backorders A flag that indicates whether OroCommerce accepts backorders. When set to Yes, buyers and sales people can order products in the quantities that are not currently available in the warehouses. The remaining portion of the order will be sustained until the product gets back in stock.
    Decrement Inventory

    A flag that indicates whether OroCommerce decrements inventory upon order.

    When both Decrement Inventory and Backorders are enabled, a product quantity may become negative.
    Minimum Quantity to Order A minimum quantity that a buyer or sales person can claim in the RFQ, customer order, quote, or a shopping list.
    Maximum Quantity to Order A maximum quantity that a buyer or sales person can claim in the RFQ, customer order, quote, or a shopping list.
    Is Upcoming This option informs a customer that the product of the selected category is not in stock currently, but will be available later. When set to Yes, additional Availability Date is displayed. To remove the upcoming products label, set the option to No or customize the required behavior in the system configuration.
    Availability Date The date which indicates the exact date and time since when the selected product will be available in stock.
  3. The Activity section displays all the activities available for the selected category, such as call, task, email, note, or calendar event. You can use filters to select any activity type and a date of its implementation.

  4. In the Visibility section, you can set a visibility restriction for the category.


    To make OroCommerce show or hide the master catalog category for a particular customer or customer group, create a visibility restriction by clicking the corresponding tab and selecting one of the following options:

    • Parent Category — Inherit the configuration from the parent category.
    • Config — Inherit the category visibility settings customized in the system configuration menu.
    • Hidden — The category will be hidden from the storefront.
    • Visible — The category will be shown in the storefront.
  5. In the SEO section, fill in the following details to help search engines show your master catalog content to the relevant audience.

    • Meta Keywords — Enter the meta keywords for the product. A meta keyword is a specific type of a meta tag that appears in the HTML code of a web page and helps tell search engines what the topic of the page is.
    • Meta Title — Enter the meta title for the product. A meta title is what is seen by search engine users and helps a search engine to index the page.
    • Meta Description — Enter the meta description for the product. A meta description summarizes a page content. Search engines show a meta description in search results if they see the searched phrase in the description.

    Click the Translations icon to provide spelling for different languages. Click the same icon again to return to the single-language view.

  6. Click Save on the top right.


You can drag the created category to a different position within the content tree on the left of the page, as illustrated below:


Create a Master Catalog Subcategory

Once you are done creating the main master catalog category, proceed to its subcategory creation.

To distribute the product items into more specific and detailed product families, create a master catalog subcategory:

  1. Select a category to link a new subcategory to.

  2. Click Create Subcategory.

  3. Provide the information following the guide in the Create a Master Catalog Category section.


Please note that one product item cannot be linked to both a category and a subcategory.

Browse maintained versions:3.11.6

You will be redirected to [title]. Would you like to continue?

Yes No
Back to top