ssossossosso
Documentation Home »User Guide »Products »Configure Products in System Configuration
current version

Configure Products in System Configuration

OroCommerce groups product configuration options into the following categories:

Product Units

In the system configuration, you are in control of the product unit options that apply system-wide. You may:

  • Select the rounding algorithm for product units.
  • Enable/disable the single unit mode for all products and toggle visibility of the unit code.
  • Select the primary unit and its precision.

To update the product unit settings:

  1. In the main menu, navigate to System > Configuration.
  2. Select Commerce > Product > Product Unit in the menu to the left.

Note

For faster navigation between the configuration menu sections, use Quick Search.

The following page opens.

The following options are available:

  • Unit Rounding Type – An algorithm that is used to round the volume specified for this unit (ceil, floor, half down, or half up).
  • Single Unit – When enabled, it limits the product unit to just one default value and restricts adding new product units.
  • Show Unit Code – When enabled, the unit appears next to the requested quantity; when disabled, the unit name is hidden and only quantity is displayed. This option is available only when the Single Unit is enabled.
  • Default Primary Unit – The product unit that is shown by default in the website.
  • Default Primary Unit Precision – The number of digits after the floating point that limits the Primary unit precision (e.g., 1 for 0.x, 2 for 0.xx, 3 for 0.xxx and so on).
  1. To customize any of these options:

    1. Clear the Use Default check box next to the option.
    2. Enter the updated quantity.
  2. Click Save.

Image Watermark

Global Product Image Watermark Configuration

You can control the watermark that will appear on top of every image uploaded as a part of product details.

To update the product watermark settings:

  1. In the main menu, navigate to System > Configuration.
  2. Select Commerce > Product > Product Images in the menu to the left.

Note

For faster navigation between the configuration menu sections, use Quick Search.

The following page opens:

The following options are available:

  • File — The image file with the watermark on a transparent background.
  • Size — The size of the watermark in percentage compared to the whole image.
  • Position — The watermark position on the image (e.g., top left, top, top right, left, right, center, bottom left, bottom, and bottom right).
  1. To customize any of these options:

    1. Clear the Use Default check box next to the option.
    2. Enter the updated size or select the position from the list.
  2. Click Save.

Product Image Watermark Configuration Per Website

You can control the watermark that will appear on top of every image uploaded as a part of product details per website.

To update the product watermark settings:

  1. In the main menu, navigate to System > Websites.
  2. For the necessary website, hover over the More Options menu to the right of the necessary website and click the Configuration icon to start editing the configuration.
  3. Select Commerce > Product > Product Images in the menu to the left.

Note

For faster navigation between the configuration menu sections, use Quick Search.

The following page opens.

The following options are available:

  • File – The image file with the watermark on a transparent background.
  • Size – The size of the watermark in percentage compared to the whole image.
  • Position – The watermark position on the image (e.g top left, top, top right, left, right, center, bottom left, bottom, and bottom right).

Note

If the Use System check box is selected, the system configuration is applied.

  1. To customize any of these options:

    1. Clear the Use System check box next to the option.
    2. Enter the updated size or select the position from the list.
  2. Click Save.

Image Preview on Product Listing Page

Configure Image Preview on Product Listing Page Globally

To simplify product selection for customer, you can enable product previews on product listing pages.

To enable image preview globally:

  1. Navigate to the system configuration (click System > Configuration in the main menu).
  2. Select Commerce > Product > Product Images in the menu to the left.

Note

For faster navigation between the configuration menu sections, use Quick Search.

The following page opens:

  1. When Enable Image Preview on Product Listing is enabled, clicking on the product image on the product listing page in the front store will open a pop up image gallery, rather than the product page.

  2. When Enable Image Preview on Product Listing is disabled, clicking on the product image on the product listing page in the front store will open the product page.

    Note

    By default, Enable Image Preview on Product Listing is enabled.

  3. Click Save.

Configure Image Preview on Product Listing Page per Organization

To enable image preview per organization:

  1. Navigate to System > User Management > Organizations in the main menu.
  2. For the necessary organization, hover over the more actions menu to the right of the necessary organization and click to start editing the configuration.
  3. Select Commerce > Products > Product Images in the menu to the left.

Note

For faster navigation between the configuration menu sections, use Quick Search.

The following page opens:

  1. When Enable Image Preview on Product Listing is enabled, clicking on the product image on the product listing page in the front store will open a pop up image gallery, rather than the product page.

  2. When Enable Image Preview on Product Listing is disabled, clicking on the product image on the product listing page in the front store will open the product page.

    Note

    When Use System checkbox is enabled, system settings are applied.

Configure Image Preview on Product Listing Page per Website

To enable image preview per website:

  1. Navigate to the system configuration (click System > Websites in the main menu).
  2. For the necessary website, hover over the more actions menu to the right of the necessary website and click to start editing the configuration.
  3. Select Commerce > Product > Product Images in the menu to the left.

Note

For faster navigation between the configuration menu sections, use Quick Search.

The following page opens.

  1. When Enable Image Preview on Product Listing is enabled, clicking on the product image on the product listing page in the front store will open a pop up image gallery, rather than the product page.

  2. When Enable Image Preview on Product Listing is disabled, clicking on the product image on the product listing page in the front store will open the product page.

    Note

    When Use System checkbox is enabled, system settings are applied.

New Arrivals

Enable New Product Icons Globally

To enable New Product icons globally:

  1. In the main menu, navigate to System > Configuration.
  2. Select Commerce > Product > Promotions in the menu to the left.

Note

For faster navigation between the configuration menu sections, use Quick Search.

The following page opens:

  1. In the New Product Icons section, clear the Use Default check box and select Yes in the Show on Product View field.
  2. Click Save.

Note

To disable ‘New Product’ icons, select No in the Show on Product View field, and click Save.

Enable New Product Icons per Organization

To enable New Product icons per organization:

  1. Navigate to System > User Management > Organizations in the main menu.
  2. For the necessary organization, hover over the More Options menu to the right of the necessary organization and click the Configuration icon to start editing the configuration.
  3. Select Commerce > Product > Promotions in the menu to the left.

Note

For faster navigation between the configuration menu sections, use Quick Search.

The following page opens.

  1. In the New Product Icons, clear the Use Default check box and select Yes in the Show on Product View list.
  1. Click Save.

Note

To disable the ‘New Product’ icons, select No in the Show on Product View list, and click Save.

Enable New Product Icons per Website

To enable New Product icons per website:

  1. Navigate to System > Website in the main menu.
  2. For the necessary website, hover over the More Options menu to the right of the necessary website and click the Configuration icon to start editing the configuration.
  3. Select Commerce > Product > Promotions in the menu to the left.

Note

For faster navigation between the configuration menu sections, use Quick Search.

The following page opens:

  1. In the New Product Icons, clear the Use Default check box and select Yes in the Show on Product View list.
  1. Click Save.

Note

To disable New Product icons, select No in the Show on Product View list, and click Save.

Upsell Items

Enable and Set Up Up-Sell Products Globally

Up-sell products listed for the product in the OroCommerce front store may advertise more expensive alternatives to the product, like a newer and more advanced model, upgrades and add-ons that may look tempting when bundled with the product, etc.

In the system configuration, you can:

  • Enable and disable up-sell product management for the products.
  • Limit the number of items displayed as up-sell.

These settings may apply globally, on the organization level, and on the website level.

To update the up-sell products settings globally:

  1. In the main menu, navigate to System > Configuration.

  2. Select Commerce > Catalog > Related Items in the menu to the left.

    The following page opens.

    In the Up-Sell Products section, the following options are available:

    • Enable Up-Sell Products — Toggles managing up-sell products on/off. Enabled by default.

    • Maximum Number Of Assigned Items — A limit of related items that may be added to any product.

    • Maximum Items — A limit of up-sell products that are shown to the buyer.

      Note

      Some related items may be hidden by the visibility settings. If the list of up-sell products still exceeds the limit, only the specified number of items (top of the list) will be shown.

    • Minimum Items — The minimum number of up-sell products that may be shown to the buyer. If the actual number of products is less than this value, the up-sell products section is hidden in the front store for the product.

    • Show Add Button — Enables a buyer to order the product from the up-sell products section in the main product details. When disabled, a buyer needs to open the up-sell product details before they can add it to the shopping list.

      Show Add Button is Enabled

      Show Add Button is Disabled

    • Use Slider On Mobile — When the option is enabled, one up-sell product is displayed below the main product information. Other up-sell products are accessible using the horizontal slider. Click < and > to slide through the up-sell products.

  3. To customize any of these options:

    1. Clear the Use Default check box next to the option.
    2. Set or clear the option, or enter the quantity.
  4. Click Save.

Enable and Set Up Up-Sell Products per Organization

Up-sell products listed for the product in the OroCommerce front store may advertise more expensive alternatives to the product, like a newer and more advanced model, upgrades and add-ons that may look tempting when bundled with the product, etc.

In the system configuration, you can:

  • Enable and disable up-sell product management for the products.
  • Limit the number of items displayed as up-sell.

These settings may apply globally, on the organization level, and on the website level.

To update the related products settings per organization:

  1. Navigate to System > User Management > Organizations in the main menu.

  2. For the necessary organization, hover over the More Options menu to the right of the necessary organization and click the Configuration icon to start editing the configuration.

  3. Select Commerce > Catalog > Related Items in the menu to the left.

    The following page opens.

    In the Up-Sell Products section, the following options are available:

    • Enable Up-Sell Products — Toggles managing up-sell products on/off. Enabled by default.

    • Maximum Number Of Assigned Items — A limit of related items that may be added to any product.

    • Maximum Items — A limit of up-sell products that are shown to the buyer.

      Note

      Some related items may be hidden by the visibility settings. If the list of up-sell products still exceeds the limit, only the specified number of items (top of the list) will be shown.

    • Minimum Items — The minimum number of up-sell products that may be shown to the buyer. If the actual number of products is less than this value, the up-sell products section is hidden in the front store for the product.

    • Show Add Button — Enables a buyer to order the product from the up-sell products section in the main product details. When disabled, a buyer needs to open the up-sell product details before they can add it to the shopping list.

      Show Add Button is Enabled

      Show Add Button is Disabled

    • Use Slider On Mobile — When the option is enabled, one up-sell product is displayed below the main product information. Other up-sell products are accessible using the horizontal slider. Click < and > to slide through the up-sell products.

  4. To customize any of these options:

    1. Clear the Use Default check box next to the option.
    2. Set or clear the option, or enter the quantity.
  5. Click Save.

Enable and Set Up Up-Sell Products per Website

Up-sell products listed for the product in the OroCommerce front store may advertise more expensive alternatives to the product, like a newer and more advanced model, upgrades and add-ons that may look tempting when bundled with the product, etc.

In the system configuration, you can:

  • Enable and disable up-sell product management for the products.
  • Limit the number of items displayed as up-sell.

These settings may apply globally, on the organization level, and on the website level.

To update the related products settings per website:

  1. In the main menu, navigate to System > Websites.

  2. For the necessary website, hover over the More Options menu to the right of the necessary website and click the Configuration icon to start editing the configuration.

  3. Select Commerce > Catalog > Related Items in the menu to the left.

    The following page opens.

    In the Up-Sell Products section, the following options are available:

    • Enable Up-Sell Products — Toggles managing up-sell products on/off. Enabled by default.

    • Maximum Number Of Assigned Items — A limit of related items that may be added to any product.

    • Maximum Items — A limit of up-sell products that are shown to the buyer.

      Note

      Some related items may be hidden by the visibility settings. If the list of up-sell products still exceeds the limit, only the specified number of items (top of the list) will be shown.

    • Minimum Items — The minimum number of up-sell products that may be shown to the buyer. If the actual number of products is less than this value, the up-sell products section is hidden in the front store for the product.

    • Show Add Button — Enables a buyer to order the product from the up-sell products section in the main product details. When disabled, a buyer needs to open the up-sell product details before they can add it to the shopping list.

      Show Add Button is Enabled

      Show Add Button is Disabled

    • Use Slider On Mobile — When the option is enabled, one up-sell product is displayed below the main product information. Other up-sell products are accessible using the horizontal slider. Click < and > to slide through the up-sell products.

  4. To customize any of these options:

    1. Clear the Use Default check box next to the option.
    2. Set or clear the option, or type in the quantity.
  5. Click Save.

All Products Page

All Products page displays all available products from the master catalog grouped by categories. See All Products Page topic for more information on how to enable All Products page and include it in the web catalog or frontend menu on the OroCommerce front store.