You are browsing the documentation for version 4.1 of OroCommerce, OroCRM and OroPlatform, which is no longer maintained. Security Support ends in January 2023. Read version 5.0 (the latest LTS version) of the Oro documentation to get the updated information.
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 permissions to view a customer, customer groups, and websites to have access to 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 may be grouped based on authentication options or 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 that is defined in the System Configuration for users of all accounts.
- product – Use the option that is selected in the Visibility to All section for the product.
- category – Use the option that is selected in the Visibility to All section for the product’s category.
- parent – Use the option that is selected in the Visibility to All section for the parent master catalog category.
- customer group – Use the option that is selected in the Visibility to a Customer Group that the customer is in.
- The website visibility may 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 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 a 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 check box, 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 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
For each product, you can define whether it should be visible on a particular website. This might be necessary when a product, for example, requires special government permit in a particular country. A seller might hide it on the country’s local website until the paperwork is complete.
On the product visibility page, you can switch between websites 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.