Important

You are browsing the documentation for version 3.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.

Create a Simple Product

Hint

This section is a part of the Product Management topic that provides the general understanding of the product concept in OroCommerce.

See a short demo on how to create a simple product, or keep reading the step-by-step guidance below.

To add a new simple product and make it available in the master catalog (for internal product management) and for purchase in the storefront:

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

2. Click Create Product.

3. Select the Simple product type.

4. Select the product family to define the product options and details that will be filled in the following steps.

5. Place the product under the necessary category in the master catalog by clicking on the category. Use the search to limit the list of categories.

6. Click Continue.

The product details page appears.

7. In the General section:

   1. Enter the product SKU and name.

   2. Enter a URL slug that is used to build a human-readable URL for the product page on the storefront.

   3. Select the product status: Enabled or Disabled. When disabled, the product is not included in the catalog and is considered to be a draft.

   4. Specify whether the product should be featured or not by selecting Yes or No respectively.

   5. Specify whether the product is a new arrival. When set to Yes, the product is highlighted in the storefront.

      

   6. For Brand, select a brand from the list. Use to view the list of all available brands. To create a new brand, click +.

   7. Configure units of quantity:

      • In the Unit Of Quantity list, select the main product unit that is shown by default when you view the product details in the storefront. Available options: each, item, kilogram, piece, set.

      • In the Precision field, set the acceptable precision (number of digits after the decimal point) for the quantity that a user may order or add into the shopping list. Items and sets are usually whole numbers, and units like kilograms may get precision of 2 to allow buying a custom volume (e.g., 0.5 kg).

      • Click + Add to add more than one unit of quantity.

        

        For every additional unit, provide precision and conversion rate compared to the main unit of quantity.

        Select the Sell check box to enable selling the product in these units. Unless Sell is selected, the unit is considered to be a draft.

        You can delete the unnecessary unit of quantity by clicking the Delete icon next to it.

   8. In the Tax Code list, select the product tax code that defines the percentage of tax that may be included into the purchase order during the checkout.

      The tax calculation process depends on the tax jurisdiction that you decided to use in OroCommerce and other tax calculation options.

8. In the Short Description section, provide a short but meaningful default description that best positions the product for your target audience and will appear in the catalog listing. Move from tab to tab to localize the description by setting the required fallback option. From the dropdown, you can select whether to fall back to the default value, parent localization, or a custom value. When selecting the custom value, provide the localized version of the short description in the WYSIWYG field.

   

9. In the Description section, provide a long default description of the product that will appear on the product view page. Move from tab to tab to localize the description by setting the required fallback option. From the dropdown, you can select whether to fall back to the default value, parent localization, or a custom value. When selecting the custom value, provide the localized version of the long description in the WYSIWYG field.

10. In the Image section, add a new image to the product by clicking +Add Image and then Choose Image.

Then, select whether to show the image as main (the image is used in the product details view), listing (the image is shown in the catalog listing), or additional (additional product pictures). All three categories can be selected at the same time. To remove the image, click the Delete icon next to it.

11. In the Design section, select the page template from the drop-down.

12. In the SEO section, provide the following information:

• Meta Keywords — Enter the meta keywords for the product. A meta keyword is a specific type of a meta tag that appears in the HTML code of a web page and helps tell search engines what the topic of the page is.

• Meta Title — Enter the meta title for the product. A meta title is what is seen by search engine users and helps a search engine to index the page.

• Meta Description — Enter the meta description for the product. A meta description summarizes a page content. Search engines show a meta description in search results if they see the searched phrase in the description.

13. In the Inventory section, provide the following information:

Field	Description
Inventory Status	This setting enables you to define and modify status information for the stock of the product.
Managed Inventory	This setting defines the method for inventory management. With Use category defaults, the product’s Manage Inventory inherits the setting selected for the product’s parent category. With Use system config, the product uses the system configuration setting. Selecting Yes enables interactive updates based on the product inventory information from the Inventory > Warehouses section. Selecting No disables connection to the inventory, and uses the static Inventory Status value.
Highlight Low Inventory	This option defines if low inventory for products is displayed in the storefront.
Inventory Threshold	A minimum quantity of the product that is treated as In stock. When a product quantity drops below this value, the product inventory status becomes Out Of Stock.
Low Inventory Threshold	The minimum stock level defined for the product. Reaching the defined level will trigger a warning message to the buyer in the storefront.
Backorders	A flag that indicates whether OroCommerce accepts backorders. When set to Yes, buyers and salespeople can order products in the quantities that are not currently available in the warehouses. The remaining portion of the order will be sustained until the product gets back in stock.
Decrement Inventory	A flag that indicates whether OroCommerce decrements inventory upon order. When both Decrement Inventory and Backorders are enabled, a product quantity may become negative.
Minimum Quantity to Order	A minimum quantity that a buyer or salesperson can claim in the RFQ, customer order, quote, or a shopping list.
Maximum Quantity to Order	A maximum quantity that a buyer or salesperson can claim in the RFQ, customer order, quote, or a shopping list.
Is Upcoming	This option informs a customer that the product of the selected category is not in stock currently, but will be available later. When set to Yes, additional Availability Date is displayed. To remove the upcoming products label, set the option to No or customize the required behavior in the system configuration.
Availability Date	The date which indicates the exact date and time since when the selected product will be available in stock.

14. In the Product Price section, add fixed product prices. Note that fixed prices override the automatically generated price lists.

    Click +Add, select a price list, specify quantity, units, price value, and currency.

    

15. In the Shipping Options section, click +Add Options and provide unit, weight and weight measuring unit, dimensions (width, height, depth), and dimensions measuring unit and freight class.

16. Review translation rules for a product name, URL slug, description, and short description.

    To enter translation manually, click , clear the Use <parent translation> check box next to the required language, and provide your version of the translation.

    

17. Click Save.

Add Related Items

Once the core product information is saved, you may add related products and up-sell products to display them in the Related Items section in the product details in the back-office, and in the Related Products and Up-sell Products blocks next to the product details in the storefront.

To add related products to the product information:

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

2. Hover over the More Options menu to the right of the item and click the View icon to preview its details.

3. Navigate to the Related Items section and click the Quick Edit link in the section header.

   The Related Items page appears with the Related Products tab open by default.

4. Click Select Related Products.

5. In the Select Related Products For dialog:

   1. Select the Is Related check boxes next to the products to mark them as related. Use filter to limit the number of listed products and find the necessary items.

   2. Click Select Products.

   This will close the dialog and update the related items list with the products you have selected.

   Note

   To delete a related item, click Delete next to it.

6. Once you are done adding the related items, click Save and Close.

Now, you can configure related products globally, per organization, and per website in the system configuration.

To add up-sell items to the product information:

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

2. Hover over the More Options menu to the right of the item and click the View icon to preview its details.

3. Navigate to the Related Items section and click the Quick Edit link in the section header.

   The Related Items page appears.

4. Click the Up-sell Products tab.

5. Click Select Up-Sell Items.

6. In the Select Up-Sell Items For dialog:

   1. Select the Is Related check boxes next to the products to mark them as related. Use filter to limit the number of listed products and find the necessary items.

   2. Click Select Products.

   This will close the dialog and update the related items list with the products you have selected.

   Note

   To delete a related item, click Delete next to it.

7. Once you are done adding the related items, click Save and Close.

Now, you can configure up-sell products globally, per organization, and per website in the system configuration.