You are browsing documentation for version 5.0 of OroCommerce, OroCRM, and OroPlatform, maintained until August 2024 and supported until March 2026. See version 5.1 (the latest LTS version) of the Oro documentation for information on latest features.
See our Release Process documentation for more information on the currently supported and upcoming releases.
Manage Product Visibility
While a product on a website can be either
hidden for a customer, the way OroCommerce evaluates the product visibility might seem tricky.
An administrator must have permission to view a customer, customer groups, and websites to access the settings described in this section.
Whether the product is shown to the customer on the OroCommerce website depends on the following configuration:
- Visibility on a Website: Is the product visible to the customer (or customer group) on the website? Multiple websites with different visibility configured help split the content and settings for different target customer locations.
- Visibility to a Customer Group: Is the product/category visible to the group of customers in the storefront? Customers can be grouped based on authentication options or the type of business that the customers are in.
- Visibility to a Customer: Is the product/category visible in the storefront to the user’s organization or business unit (customer)?
Additionally, there are default visibility settings that may be easily inherited in the above configuration:
Generally, these are the available visibility settings:
- visible – Show the product in the catalog on the website.
- hidden – Hide the product from the catalog on the website.
- config – Inherit the visibility defined in the System Configuration for users of all accounts.
- product – Use the option selected in the Visibility to All section for the product.
- category – Use the option selected in the Visibility to All section for the product’s category.
- parent – Use the option selected in the Visibility to All section for the parent master catalog category.
- customer group – Use the option selected in the Visibility to a Customer Group that the customer is in.
- The website visibility can be configured individually for each website. The visibility configured for a particular website has priority over the default website visibility.
- The product visibility has priority over the category visibility. If the product is visible, but the category is hidden, the product is still visible.
- The category visibility has a higher priority than the parent category.
- The customer group visibility overrides visibility for a customer within the same website.
Visibility per Website Table
The following table summarizes visibility options per website:
The following schema illustrates all possible fallbacks where the solid lines define the fallbacks set by default.
Keep in mind that the config visibility type sets system-wide visibility for products and categories for existing customers.
You can define system-wide visibility for products and categories for existing customers. This setting applies whenever visibility is set to ‘config’.
Products and categories are visible by default. To change this, navigate to System > Configuration > Commerce > Customer > Visibility in the main menu, clear the Use default checkbox, and toggle the options (hidden/shown).
Visibility to All
The default visibility for a product or category is configured on the product’s Manage visibility page and in the Visibility section of the category details.
The possible options are:
- (parent) category – Inherit configuration from the parent category. It means that the current product visibility settings equal the value defined for the Visibility to All field of the parent category.
- config – Inherit settings from the System Configuration.
These values may be later inherited or enforced for customers and customer groups (For this, their visibility must be set to ‘product’ or ‘category’).
Visibility to a Customer Group
You can control if the product or category is shown to the customers who are members of a particular customer group. Use one of the following options:
- product – Inherit configuration from the product.
- category – Inherit configuration from the parent category. It means that the current product visibility settings equal the value defined for the Visibility to Customer Groups field of the parent category.
By default, a new customer group inherits the default product visibility from the product or category (depending on where the configuration happens).
Visibility to a Customer
Visibility to the customer supports the same options as Visibility to a Customer Group and can also inherit the configuration of a customer group (by default).
Visibility on a Website
You can define whether each product should be visible on a particular website. This might be necessary when a product, for example, requires a special government permit in a particular country. A seller might hide it on the country’s local website until the paperwork is complete.
You can switch between websites on the product visibility page and apply the necessary changes.
For new websites, the following default settings apply:
- Visibility to all inherits visibility configuration of the product’s category.
- Visibility to customer group inherits visibility configuration at the product level.
- Visibility to customer inherits settings for the customer group.