You are browsing documentation for version 5.1 of OroCommerce, supported until March 2026. 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.

Set Up the Homepage, First Level Menu, and Sub Menus 


The homepage that is shown when a buyer navigates to the web store is configured by the very first node created in the web catalog (homepage node).

The first level of the main menu in the storefront is represented by root content nodes in the back-office.


The homepage node displayed in the storefront


The homepage node configured in the back-office

Root content nodes are nested under the homepage node.

After you set up the first level of the main menu, you can set up the second level for it, as well as many other sub-levels for them, depending on the structure envisioned by you for the store.

Several sub-levels of the root content node nested under the homepage node

The steps for node configuration provided below apply to the homepage, main menu and sub-menu content with the only difference in the way you launch the node configuration:

  • For homepage node — You will be offered to fill in the homepage details once you start editing a blank content tree.

  • For menu and sub-menu nodes — To create a menu or sub-menu node, select the parent node you would like to place it in, and click Create Content Node.

  • To launch editing the existing content node configuration, select it in the content nodes tree.

Content Node Configuration 

To create or configure the content node in the web catalog:

  1. In the General section, fill in the content node title.

    For the homepage node, the title is mentioned in the content nodes tree in OroCommerce back-office.

    For the menu and sub-menu nodes, the title is mentioned in the content nodes tree in OroCommerce back-office and shows as a menu or sub-menu caption in your OroCommerce storefront (depending on the level in the content tree).

    If necessary, translate the title into the languages supported in your OroCommerce configuration. To manage title translations, click next to the Titles box and follow the content translation guidance here.

  2. Set Rewrite Variant Title to override the native title of the alternative content that you are mapping to this catalog node with the content node title specified in the previous step. When the content variant has no title of their own, the option is ignored and the content node title is used.

  3. For the menu and sub-menu nodes, enable the Slug Prototypes box. The default slug prototype is autogenerated. Edit the value to customize the default.

    To ensure that slug prototype translation is localization-friendly, manage slug prototype translations: click next to the Slug Prototypes box and follow the guidance on content translation.

  4. In the SEO section, fill in the meta description and meta keywords to help search engines show your web content to the relevant audience. Similarly to the title, meta information can also be translated.

  5. In the Restriction section, define the visibility of the web catalog.

    By default, the web catalog is displayed for any localization, on any website, and for any customer.

    To make OroCommerce apply a web catalog to the storefront only for the particular combination of these facts, create a restriction by selecting all or some of the following: target localization, website, and customer or customer group.


    Only one field must be chosen for customers at a time, either a customer group and a customer.


    Never leave the restrictions for non-default variant empty. This may cause unexpected priority collision between the default and non-default variant.

    For the menu and sub-menu nodes, the settings are inherited from the parent node. To modify the inherited default settings, clear the Inherit Parent box, and specify the necessary restrictions.

    clear the Inherit Parent box Additional restriction settings appear when clearing the Inherit Parent box
  6. In the Content Variants section, add the default content item to be displayed in the OroCommerce storefront when the node-level restriction conditions are met:

  • Select the type of content to be displayed in the storefront from the list on the right.

    Select the type of content to be displayed in the storefront
  • Configure the content node as described in the Configure Content Variants for the Content Node section.

    If necessary, create alternative content variants by selecting a content type from the list on the top right of the Content Variants section and providing the set of conditions (localization, website, customer or customer group) to restrict this variant specifically for those cases. To switch the default content variant to a different item, select it using an option to the left of the content variant name.