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.
Product Management Concept Guide
Configuring your online web store for success means making it easy for users to browse your site and find the product they search for. With the optimized product pages, you can showcase your goods and services in the most appropriate way increasing your conversion and sales.
Usually, good graphics and visuals are the top factors that affect user’s purchase decision. An appealing visual representation of a product in the storefront requires no less complex work in the backend. OroCommerce enables you to develop a product page that can be properly arranged and optimized based on your requirements and business needs. A product page can display any information ranging from variations of one product, featured products, related and up-sell products in the way you desire and to the customers you prefer.
The configuration of a product may differ depending on your business strategy, sales, volumes, location, and visibility restrictions. But the logic for creating a product is unique. Below, we will dive further into it.
Product Components
Product management in OroCommerce comprises several elements that provide an organized structure to your product pages. These are:
product units
product attributes
attribute groups
product family
brands
To illustrate the dependencies of these elements, and why they are essential for the product creation and configuration, let’s take a look at the following product information:
Product units — determine the quantity of a product. They are the units of measurement, such as item, hour, kilogram, piece, or set. A product can have one or multiple product units which enables customers to select the required one in the storefront.
Product attributes — are specific characteristics of a product, such as type, color, size, style, inventory status, brand, etc. You can create as many attributes as you want to specify more details of a product. Keep in mind that some attributes are system attributes that are built in the OroCommerce platform (e.g., name, description, sku, price). Such attributes cannot be modified or deleted. You can also make the attributes filterable and enable customers to find the product by setting the necessary parameters in the storefront.
All product attributes are grouped into dedicated attribute groups that organize your product page. Attribute groups are the tabs or titled sections that combine similar parameters. Following this, the SEO section, for example, would include meta title, description, and meta keywords. You can create any attribute group that would fit your products with any attributes that would describe those products the best. All attribute groups are arranged into a product family.
A product family — combines all attributes related to a specific product. If you have different product types (e.g., TVs and digital cameras), it is better to create an individual product family per each type. This way, your customers will see only the relevant attributes associated with your products. For example, such attributes as resolution and number of hdmi inputs can be included into the TVs product family, while megapixels and sensor size would be the attributes of the digital cameras product family. If you put all your attributes into one product family, your customers will see irrelevant filters in the storefront that can affect their purchasing decision. As for the system attributes, they are included into all product families by default, as they contain the core information of a product, such as a name, sku, descriptions, and meta tags.
Product brands — are system attributes assigned to each product by default. You can create a list of brands in the back-office, and then, associate your products with a specific brand for easier search in the storefront.
All the product components are used when creating simple and configurable products. If you are not sure where to start when creating a product, follow the sequential steps below for the reference:
Simple vs Configurable Products vs Kits
In OroCommerce, products can be of three types, simple, configurable and kits. The product type selected at the first step of product creation in the back-office determines the way product information is used and managed in OroCommerce.
Simple products are physical items that exist in a basic, single variation. Their qualifiers, such as color or size, cannot be modified meaning customers cannot select the same product with slightly different characteristics. Simple products have a unique SKU and serve as ‘building blocks’ for configurable products. You can manage the inventory information and the price for a simple product.
Unlike a simple product, a configurable product is an item available in multiple variations. Customers configure the product in terms of its color, size or any other applicable parameters according to buying needs. Buyers in the storefront choose from the options provided to ‘configure’ a product according to their needs.
However, in the back-office, configurable products are more sophisticated. A configurable product is known as a single parent product uniting multiple product variants. These product variants are assigned unique SKUs for easy inventory tracking, have their own inventory and price settings, and are generally treated as separate products in product information management (PIM) UIs. As the configurable product and all of its variants share the same set of attributes, they share the product family.
For example, a USB flash drive may be available in various colors and capacity (e.g., Red USB drive 64 GB, Red USB drive 256 GB, Green USB drive 128 GB, Black USB drive 64 GB). In this case, the generic USB flash drive is a configurable product, Red USB drive 64 GB, Red USB drive 256 GB, Green USB drive 128 GB, and Black USB drive 64 GB are product variants (created as simple products), and color and capacity are configurable attributes in the generic USB flash drive.
A configurable attribute is one of the product attributes that are used to distinguish product variants of the same configurable product. There should be at least one configurable attribute specified for the configurable product in order to enable the customer to perform product variant selection.
To purchase multiple product variants in one order, use a matrix order form in the storefront. It provides improved visibility into product offerings and enables you to create complex bulk orders quickly.
A product kit is an assortment of products, each with their individual SKUs. Each product in this assortment bundle can be mandatory or optional for the buyers to buy in order to proceed though the checkout. An example of a product kit would be a lamp with a selection of optional accessories or services for it, such as spare bulbs of different wattage or warranty.
Note
Product Kits in the back-office are available as of 5.1LTS. Product Kits in the storefront are available as of 5.1.3. By default, the product kits feature is disabled for v.5.1 but you can enable it with developer assistance in the yaml file of the ProductBundle.
Products in a Multi-Org Application
Products, product attributes, and product families are managed per organization. Whenever you create a new organization, a default product family is created automatically.
Note
Products from other organizations are not visible in the storefront. If you want multiple websites to share the same product collection, make sure that these websites are in the same organization.
Note
The multi-org and multi-website functionality is only available in the Enterprise edition.
If you have a multi-org application, you can create products with the same SKU and URL slug in different organizations. You can also manage the product attributes of each organization independently of other organizations in the system. It means that any product attribute modifications fulfilled within one organization do not affect the product attributes available in others.
Some product attributes are global, which means that they were created in the global organization and can only be managed by its admins. You can use global attributes in other organizations but not edit them or create a new product attribute with the same name as a global attribute.
Products in the Storefront
There is a number of ways to display your products effectively in OroCommerce.
When the required number of products has been created or imported, you can further improve on their visual representation in the storefront to simplify purchase choices for your buyers, help engage your target audience, and convince them to make the purchase. Usually, these options are configured per level.
The products that appear on the home page of the OroCommerce storefront are customized through the configuration settings of:
A master catalog or a web catalog that organize all existing products in your store by categories.
A featured products segment that displays the selected products on the crowded paths of you website.
A new arrivals segment that showcases a few new products of your store that you want to promote.
A new product icon that highlights the products as new.
A product image watermark that can be added on top of the images for the selected products.
On the product details page, you can configure the following options:
A product image gallery that controls the way the product options are displayed on the product page. You can select whether to use popup or inline view for the image gallery.
A related products block that binds similar products related to those currently browsed by the customer or those that complement each other, like the laptop and its accessories, a mouse, notebook bag or screen cleaning cloths.
An up-sell products block that binds products that should be promoted with the product selected by the customer, like more expensive alternatives of the model, upgrade options, additional parts. Taking the example of the laptop, that would be a laptop with a larger screen, better processor, or higher hard drive capacity than the customer planned to buy.
A similar products block that automatically shows products similar to the current one, like similar laptops on the laptop page. The more common traits a similar laptop shares with the original laptop, the higher it is in the list.
Note
Similar products are available for the OroCommerce Enterprise edition if Elasticsearch is used as the search engine.
You can configure the All Products page to display all available products from the master catalog grouped by categories. Here, you can also customize the image preview on product listing page to see the product image gallery instead of the product page when clicking on the image in the product listing.
As you can see, with OroCommerce you can create an appealing and functional product pages that are the key to sales in online stores of all kinds.
Business Tip
What is B2B eCommerce and how it can benefit your business? You’ll find answers to this and other commerce-related questions in our guide.
Related Articles