Important

You are browsing the documentation for version 4.1 of OroCommerce, OroCRM and OroPlatform, which is no longer maintained. Read version 5.1 (the latest LTS version) of the Oro documentation to get up-to-date information.

See our Release Process documentation for more information on the currently supported and upcoming releases.

Available in OroCommerce

Manage Product Visibility

While a product on a website can be either visible or hidden for a customer, the way OroCommerce evaluates the product visibility might seem tricky.

Note

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:

Visibility Options

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.

Visibility Priorities

  • 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:

A table that summarizes visibility options per website

The following schema illustrates all possible fallbacks where the solid lines define the fallbacks set by default.

A schema that illustrates all possible fallbacks

Note

Keep in mind that the config visibility type sets system-wide visibility for products and categories for existing customers.

Default Settings

System Configuration

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).

View the global visibility settings for products and categories under the system configuration page

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.

View the product Visibility to All settings

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.

  • hidden

  • visible

These values may be later inherited or enforced for customers and customer groups (For this, their visibility must set to ‘product’ or ‘category’).

Direct Settings

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.

  • hidden

  • visible

By default, a new customer group inherits the default product visibility from the product or category (depending on where the configuration happens).

View the product Visibility to Customer Groups settings

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).

View the product Visibility to Customers settings

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.

View the product visibility settings applied individually per website

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.