Important
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.
Web Catalog Management Concept Guide
Web catalogs are a powerful content management tool that enables sellers to create unlimited customizable and personalized versions of their OroCommerce storefronts to provide an engaging and personalized experience for B2B customers.
Visually, a web catalog represents the main navigation bar of the storefront website. It enables buyers to browse the product catalog, click on products to view details, and add them to shopping lists before ultimately buying them. Under the hood, OroCommerce sellers can not only build new catalogs from scratch but also modify default catalogs, customizing and enriching them with new menu items for various localizations, customers, or customer groups.
Sellers can add new pages to existing catalogs or create all new catalogs. They may want to change out catalogs seasonally or create a catalog for a VIP promotion or sale and redirect particular customers to the promotional page. With restrictions, it is easy to ensure that only specific customers can access these personalized pages.
Business Tip
Are you looking for the best eCommerce platform for B2B organizations? Evaluate your options with our platform comparison chart.
Web Catalog Elements
In the back-office, a web catalog consists of the content tree (the catalog structure), populated with content nodes (catalog categories). Building a catalog tree structures the product collection and defines the storefront menu look and feel.
A good first step when it comes to building a web catalog is creating the root content node, followed by adding the first level menu items that represent menu headers, for example:
Outdoor & Garden
Building & Hardware
Lighting & Electrical
and then populating them with child (content) nodes:
Outdoor & Garden: Garden Furniture, Garden Tools, Fencing
Building & Hardware: Building Supplies, Doors & Windows, Timber & Sheet Materials
Lighting & Electrical: Lightning, Home Electrical, Smart Home
Each of these nodes can have more child categories:
Fencing: Fence panels, Garden Gates, Gravel Boards
Timber & Sheet Materials: Timber Cladding, Skirting Boards, Decorative Mouldings
Smart Home: Voice Assistants, Cameras, Heating, Doorbells
Hint
In addition to the catalog items, the main storefront menu can also contain static custom menu items, such as Contact Us or About. These custom menu items are not part of either master catalog or web catalog and can be moved to a different section of your storefront. Please see the documentation on frontend menu items to learn more.
Every child node must be populated with content variants. Content variants are the types of pages that you add to the content node. These pages can be of the following types:
System page – one of many standard pre-designed pages for the OroCommerce storefront(Sign In page, Open Orders page, Request a Quote page, etc.)
Product page – a direct link to product details
All Products page – a collection of all products usually added for smaller catalogs with no more than a few hundred products
Category page – a direct link to products from a master catalog category
Product Collection page – a dynamic collection of products that you filtered/selected manually or in bulk to be displayed for this page
Landing page – a direct link to a custom content page
Resource Library – if you download a Resource Library Extension, you can add media content, such as news, banners, product review videos, safety specifications, etc.
Hint
It is possible to add a custom content page and link it as a content variant, but this requires some customization effort.
You can configure more than one content variant per node, in case you want to display different variations of a page to different customers. By default, the web catalog with all its nodes has no visibility restrictions and may be displayed for any localization, on any website, and for any customer. However, depending on your business processes, you can adjust web catalog nodes to be displayed in a particular localization (e.g., Germany, UK, France, etc.), on a specific website (e.g., B2B, B2C, Europe, Australia), and/or for the selected customer(s) or customer group (e.g., Non-Authenticated Visitors, Wholesalers, Partners, etc.), while keeping the same URL.
You can also control which section of the web catalog to display on your website. By configuring a navigation root, you select relevant categories that you want to be included, instead of the whole web catalog content tree. For example, build the main menu starting from the Smart Home content node and its child nodes.
You can use the nodes excluded from the main menu. For example, create a category and add it as a separate block in the storefront homepage as part of the featured menu. This block can lead to a product listing page with a number of discounted items with the product listing page 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).
Web Catalogs in a Multi-Org Application
Note
The multi-org functionality is only available in the Enterprise edition.
Each organization in a multi-org Oro application is a clean slate with a separate inventory, catalogs, products, and the organization configuration options that may or may not fall back to the system configuration.
When you create a new organization, you also need to build a new web catalog as web catalogs and products are not replicated from one organization into another.
The only organization that can display web catalogs and products from different organizations is called global. Users in the global organization, given they have Global access levels in their role, can access and control all system data in all organizations within one instance of the application.
Web Catalogs and Websites
Note
The multi-website functionality is only available in the Enterprise edition.
You can build as many catalogs as you need in each organization within one Oro application, but you can assign only one web catalog per website (via the website configuration). That said, there is no limit to how many times you can reuse the same web catalog for other websites.
Hint
Web catalogs can only be assigned to websites, not customers or customer groups.
Web Catalogs and Consents
Customers want and deserve to feel their data is safe when shopping online, that is why online businesses must comply with data protection regulations, such as CCPA or GDPR. One of the data protection obligations is to give customers greater access to their personal information and let them have more control over it. OroCommerce allows you to create and manage customer consents while enabling buyers to view, manage, and revoke these in your storefront.
Note
See Consent Management Concept Guide for more information on data protection.
To be able to display the text of the consent to customers in the storefront, you need to create a consent landing page with the corresponding description and add it as a content variant for a specific node in a web catalog.
As contents in OroCommerce can be either mandatory or optional, you may or may not require to add a landing page with a consent description to your catalog. The rule of thumb is that if your consent does not require any descriptive text, or if your consent is optional, you do not have to add it to the web catalog node as a landing page. However, if you need to comply with the GDPR, make sure that the mandatory consent has a detailed description of the terms that the buyer should agree to, in which case you should add this consent as a landing page to the selected web catalog node.
Web Catalog and Master Catalog
An OroCommerce application does not have to have a web catalog to display your product collection, as you can use the master catalog. The structure of the master catalog is always displayed in the storefront when you have no web catalog, or it is not connected to the website (in the system configuration globally or per website).
However, using a web catalog over a master catalog has its perks, as it offers more flexibility to create different versions of one OroCommerce application, catering for different needs of different B2B buyers.
The following table summarizes the difference between a master catalog and a web catalog:
Master Catalog |
Web Catalog |
Notes |
|---|---|---|
No |
Yes |
Unlike the master catalog, a web catalog enables you to add a filter-based segment to select and display a dynamic set of products in the storefront. For instance, you can create a product collection segment for a special promotion using a variety of filters and conditions, such as putting on sale all products that are in stock but with inventory lower than 500 items. |
Master Catalog |
Web Catalog |
Notes |
|---|---|---|
No |
Yes |
There is always only one master catalog per organization but multiple web catalogs. |
Master Catalog |
Web Catalog |
Notes |
|---|---|---|
May affect product |
Do not affect products |
The visibility of a product is determined based on the master catalog category, not a web catalog node. This is because one product can relate to many web catalog nodes (e.g., one web catalog category may be hidden, the other one visible), which would make it difficult to determine the product’s actual visibility. You can also determine product visibility on the product level. By default, product visibility depends on the master catalog category visibility (i.e., if you hide a master catalog category, you hide all products of this category in the web catalog). You can change this visibility behavior per product, if necessary, in addition to changing product visibility per website. However, keep in mind that product visibility has priority over the category visibility. If the product is visible, but the category is hidden, the product is still visible. |
Changing Storefront’s Product Menu
Whether you use the master catalog or a web catalog to display your product collection on the website, you can further modify how your storefront menu looks by using the frontend menu.
There are several frontend menus that make up the navigation of the website storefront. The one that allows you to customize the main navigation menu in your storefront is called commerce_main_menu. It reflects the existing structure of your master catalog or selected web catalog and presents you with options to customize the name and position of its categories in the storefront without affecting the original master or web catalogs.
Hint
Although commerce_main_menu is the default main navigation menu, it can be changed in the system configuration.
Commerce_main_menu is located under System > Frontend Menus.
Here, categories in the tree to your left constitute the main menu your customers see on the website.
When no web catalog is connected, commerce_main_menu is populated with the structure of the master catalog, and the target type of the system items is set to Category. When you connect a web catalog and define the navigation root, system menu items in the menu is set to Content Node.
You can modify system items (which are reflection of the items from web/master catalog), or add new custom items altogether. After you add a new item to a particular parent category, you can drag and drop it outside its parent up or down the tree.
You can also add promo images to the menu and add links to them. In the screenshot below, the image is created as a new menu item with target type URI and placed 2 levels deep in the tree.
If you place such an image higher or lower than level 2, it will be displayed as a menu item, which means that you will only see the title of the menu item but not the image. This is the default behavior, and customization is required if it needs changing for your business needs.
Synchronization with Original Web Catalog
The tree displayed on the left-hand side of the main menu represents the structure of the navigation root of the content node from your selected web catalog (or the categories of the master catalog if a web catalog is not connected). The information copied from the web catalog is considered system information and can be modified only partially. For example, you can change the category title, but the target type, content node, and web catalog options will be disabled from editing. If you are creating a new menu item or updating an item you created previously, you can update any information without exception.
Every item in the tree is synchronized with the web catalog until you manually update the item in the commerce_main_menu, in which case your changes have priority. The system will not overwrite them if the original menu item is updated in the web catalog.
In the example below, we have changed the title of category New Arrivals to New In via commerce_main_menu. As you can see in the screenshot below, the category’s name in the original web catalog is unchanged, and the storefront uses the title from the frontend menu.
Like with the change in the title, you can change the order of the menu items by dragging and dropping them under the required parent item without affecting the original web catalog. When you change the order of the items, your changes will have priority over any potential future changes in the web catalog order.
Use Cases
Using Master and Web Catalogs Together
As no business is alike, OroCommerce can be easily adapted to your business processes. Some sellers may be comfortable enough to use the master catalog to display all their product collection, and some may have more complicated processes, where interchanging web catalogs is their key marketing strategy.
One of the common ways approach catalogs is to section the main menu into Products and Brands, where both of these items are built through the web catalog. Products in this case fully mirror the structure of the master catalog, while Brands categorize and filter all product collection based on the brand names.
Keeping the structure of the master catalog in Products helps adhere to a unified organization strategy, but using a web catalog as the tool for publication helps reuse existing products for Brands. This would not be possible via standard master catalog publication, as in the master catalog products can only be used once.
Related Topics
Further Practice