Adding Product Definitions

Think of the product definition as a template to display your product characteristics and define parameters that are required to communicate with external systems.

The product definition includes the Product Display Name, Description, and selected Default, Custom, and Variant Attributes and Prices.

Example: Create a product definition for shoes that has specific requirements such as the size, material and heel height. You can also create a different product definition for coats requiring different or additional attributes.

Adding a product definition

1. In the Administration module, select Product Definitions.
2. Click Add Product Definition in upper right corner.
3. Specify a unique Name for the definition. Accents and special characters are not allowed.
4. Enter a Description. This description helps users understand the purpose of the product definition.

Figure 1 - Creating a product definition

Note: Just as with Product IDs, Product and category definitions names must be unique throughout the platform. Using a product or category definition name that already exists will result in an error while saving it.

Figure 2 - Error: The name is already in use

5. OPTIONAL: If the products in this definition require prices, select The products in this definition will have prices.
6. Click Save.

The product definition is created, you must now specify the custom, variant and key variant attributes.

Tip: When a category definition or product definition ID is already in use, it does not mean you cannot use it in your category nomenclature. The category definition and product definition IDs are unique names used throughout Orckestra Commerce Cloud. However, the display names can be changed as you please. For example. you can have a main category named Women and a sub-category named Women elsewhere in your category tree.

Adding Custom Attributes to a Product Definition

Important: The default attributes are system attributes. They cannot be modified or deleted.

To learn more about custom attributes and variant attributes, see Working with Attributes and Understanding Products.

1. Select Custom Attributes.
2. Click Manage Custom Attributes in the upper right corner.
3. In the Available Attributes column, select one or many attributes.

Figure 3 - Adding product attributes to a definition

Tip: To pick multiple attributes at the same time, hold the SHIFT or CTRL key and click the attributes.

4. Click Add.
5. Click the Back arrow.
6. Click Save.

Adding variant and key variant attributes

Important: Attributes of type currency, date and time, or multi-select lookup list cannot be used as key variant attributes. In this situation, the toggle button under Key Variant is not displayed.

First, you will define variants. Once they are selected, you will specify which selections become key variant attributes.

1. Click Manage Variant Attributes in the upper right corner.
2. In the Available Attributes column, select one or many attributes that you will use as variants.

Figure 4 - Adding product attributes

Tip: To pick multiple attributes at the same time, hold the SHIFT or CTRL key and click the attributes.

3. Click Add.
4. Click Back.
5. Slide the toggle button for each variant attribute you want to define as key variant attribute.

Figure 5 - Defining a key variant attribute

6. When an attribute is defined as a variant, you can also assign it as a group.

Example: when a variant is assigned as a group, the variant name appears as a group in the Variants > Information tab of a product.

Figure 6 - Variant assigned as a group example

7. Click Save.

Result: You created a product definition and defined product attributes, variant attributes as key variants.

Attention: Adding variants to an existing product definition impacts all products that share the same product definition, including those for which the inheritance is broken.

REFERENCES

Managing Product Definitions
Creating Products
Understanding Products