You are browsing the documentation for version 4.2 of OroCommerce, OroCRM and OroPlatform, which is no longer maintained. Read version 5.1 (the latest LTS version) of the Oro documentation to get up-to-date information.

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

Available in OroCommerce

Use Web Catalog Nodes as Root Nodes (Example)

You can select any content node as a root node for the OroCommerce storefront menu. This enables to display only the necessary sub-menu nodes in the storefront menu.

As an illustration, we are going to create a category and add it as a separate block in the storefront homepage as part of the featured menu. The block will lead to a product listing page with a number of discounted items. The product listing page will not be part of the main menu and will only be available via a link from the new featured menu block on the homepage (e.g., Special Offers).

To configure such behavior, follow the steps outlined in the sections below.


The following illustration involves configuration options that may only be modified by an administrator or a person with the permissions to access system configuration settings.

Step 1: Configure the Navigation Root

Define the navigation root for the main menu so that the only relevant categories are displayed in the storefront instead of the whole web catalog tree:

  1. Navigate to System > Websites > Routing in the main menu.

  2. In the Navigation Root field, select a content node as the root for building the navigation tree in the storefront.

    Navigation root system configuration
  3. Click Save Settings .

Once the navigation root scope is defined, the main menu in the storefront should display the sub-menus only from the selected navigation root range.


Keep in mind that the Navigation Root option appears in the routing configuration settings when you clear the Use Default check box next to the Web Catalog field, select the necessary web catalog from the list (if you have more than one), and click Save Settings.

Step 2: Add a Content Node

Create a new content node and add all the items eligible for your special offers:

  1. Navigate to Marketing > Web Catalogs in the main menu.

  2. Click Create Content Node outside of the Navigation Root range and provide it with a name (e.g., Special Offers). The URL slug is automatically generated, but you can modify it, if necessary.

    Creating a content node outside of the navigation root
  3. In the Content Variants section, add Product Collection as a content variant for the node you are creating, and populate it with the items for sale. In the example below, we have applied an existing segment (New Arrivals/Lightning Products) to the product collection that we are adding as a content variant.


    See the Add a Product Collection (Web Catalog Content) topic for more details.

    Product collection content node
  4. Click Save.

Step 3: Add a Frontend Menu Item

Add a new menu item to the existing featured menu block in the storefront:

  1. Navigate to System > Frontend Menus in the main menu.

  2. Click once on the featured_menu item to open its page.

  3. Click Create Menu Item.


    See the Edit a Frontend Menu topic for more information on frontend menu configuration.

  4. Name the menu item, and paste the URL slug of the content node you created in step 2 (e.g. /special-offers). Once you append the URL, clicking on this block on the homepage will lead to the collection of products on offer.

  5. Add an icon or an image to the menu item (optional).

    A new frontend menu item added to the featured menu in the back-office
  6. Click Save.

    The block should now be displayed in the storefront homepage.

    A new frontend menu item added to the featured menu in the storefront

    Clicking on the Special Offers block will redirect you to a dedicated page excluded from the main menu with the collection of items selected for the sale.

    Special offers page in the storefront

More on Web Catalogs