Important

You are browsing the documentation for version 4.2 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 Price Attributes in the Back-Office

A Price Attribute is a custom parameter, like manufacturer’s suggested retail price (MSRP), minimum advertised price (MAP), or shipping cost that may be needed as input information for your retail price listed on the website. Price attributes help you extend the product options with any custom value related to the price formation.

Before reading on, consider watching a short demo from our media library on how to set up price attributes in OroCommerce.

You can use the price attribute as a base value for manually or automatically generated price list.

Create a Price Attribute

To create a new price attribute:

  1. Navigate to Products > Price Attributes in the main menu.

  2. Click Create Price Attribute. The following page opens:

  3. Type in the price attribute name (that is used as a UI label) and the field name that is used in the code and in the database to refer to the price attribute container.

  4. Select the currencies that are supported for this price attribute:

    • Click the currency to select only one of them.

    • Hold the Ctrl key and click another currency to add it to the selection.

    • Hold the Shift key and click another currency to select a range of currencies.

  5. Click Save.

Now you can set the price attribute value for every product in the Product Prices section:

Display the location of the product price attributes

Manage Price Attributes

View Price Attribute Details

To view all price attributes, navigate to Products > Price Attributes in the main menu.

The page of all price attributes

Here, you can create a new price attribute, filter the list of existing ones by a price attribute name or a field name, view price attribute details by clicking on the item. Also, you can view, edit, or delete a price attribute by hovering over the More Options menu to the right of the item.

To remove multiple price attributes, select check boxes in front of the price attributes that you want to delete. At the right end of the list header, click the More Options menu and click Delete to remove all selected price attributes.

Find the necessary price attribute in the list and click on it.

The following information is available immediately:

  • Price Attribute – The name or label of the price attribute.

  • Field Name – The name of the field in the code/database that represents the price attribute.

  • Currencies – The currencies this price attribute is supported for.

  • Enabled in Product Export – If enabled, this price attribute will be used in the storefront product listing export.

Price attribute edit page

Edit a Price Attribute

To edit a price attribute:

  1. Navigate to Products > Price Attributes in the main menu.

  2. Hover over the More Options menu to the right of the item and click Edit to start editing its details.

  3. Amend the price attribute name (that is used as a UI label) and/or the field name that is used in the code and in the database to refer to the price attribute container.

  4. Modify the selection of the currencies that are supported for this price attribute:

    • Click the currency to select only one of them.

    • Hold the Ctrl key and click another currency to add it to the selection.

    • Hold the Shift key and click another currency to select a range of currencies.

  5. Click Save.

Next, in the product details, adjust the price attribute values and provide values for newly added currencies.

Set a Price Attribute Value in the Product Details

To set a price attribute (e.g., Minimal Advertised Price) for a product:

  1. Navigate to Products > Products in the main menu.

  2. Hover over the More Options menu to the right of the item and click Edit to start editing its details.

    Price attributes such as MSRP and MAP are available under the Product Prices section of the product view/edit page:

    Price attributes in the Product Prices section of the selected product

    Shipping cost price attribute information is available under the Shipping Options section of the product view/edit page:

    Illustration of shipping cost information on the product view page

    Shipping cost can work in conjunction with a shipping method, such as Fixed Shipping Cost. For example, if the shipping cost for a product is set to $2.70 and the surcharge configured for the Fixed Shipping Cost shipping method is $3, then the shipping charge at checkout will equate to $5.70.

    Illustration of how shipping cost set for the price attribute works on combination with the surcharge defined in the fixed product shipping cost integration

    Hint

    Fixed Product Shipping Cost is available starting from v4.2.11. To check which application version you are running, see the system information.

  3. Provide the value per unit and currency.

  4. Click Save.

Now you can use the price attribute as a variable parameter in price list generation.