Products

Create and manage different product types.

In the Products section, you can see the list of products, along with their images. They can be filtered by name, ID, and price, and can be displayed in ascending or descending order.

Products list view

Products list view

You can manage the products view by using the options available under the orchestration icon.

Orchestration icon

With the table orchestration, you can add custom columns to the list view, by adding mixin fields as columns. If you have already defined mixin schema for the entity, you'd be able to select the defined mixin fields to display them in the main view.

See example how to do it in the Displaying mixins in entity list view documentation.

If you want to view the products by the way they are classified, you can open the category-tree view.

Products category-tree view

In this view, you can download a .csv file with products belonging to the catalog that is currently displayed in the list. Choose the download option to get the .csv file.

Download CSV icon

To remove your products, you can either delete single items from the list, or delete multiple items. To delete multiple items at once, select the chosen items and then click Batch Delete.

Using Management Dashboard, you can only delete up to 30 items at once. 30 is the maximum number of items that can be displayed on one page.

• Looking for business guides? Check out the Products guide.

• Looking for code tutorials and API reference? Check out the Products API documentation.

Create a product

You create new products in the Products -> Products view. After choosing the Add new product, you have several options to choose from:

• Basic – Create a single basic product.

• Bundle – Create a package of products sold together.

• Variant – Create different versions of the same product using a product template. Variant products share the same attributes as their parent product but can differ in size, color or other specifications.

• Variant Hierarchy – Create flexible multi-level variants on the fly without any template.

Creating different product types menu

Create a basic product

1

Choose to add a product

After opening the Add new product, select the Basic option.

2

Provide the required data

In the General tab, provide all the mandatory data that is needed to create a product. The mandatory fields are marked with an asterix (Name and Code).

• You can set up a custom product ID in the Id field. Otherwise, a unique ID is automatically generated when the product is created. The ID is used in other parts of the product's data configuration.

• To mark a product as weight-dependent, toggle the Weight-Dependent option on. A product should be marked as weight-dependent if its final price may change after packaging, as this ensures that credit card payments can be properly authorized.

You can also choose a product template to add customized product attributes. If you choose a Product template, you can see the list of attributes available in the template and the available template versions.

Before proceeding to the next tabs, choose Create to save the product details in the General tab. The product is added to the database and the product ID is automatically assigned.

The ID is needed in other parts of the product data configuration.

For more information about templates, see Products Templates documentation.

3

Assign a product to a category

To improve organization and navigation, assign your product to a category – either a standard category or a classification category. You can assign both types in the Category tab within the product view.

Standard Category

Assign the category by going to the Categories tab and selecting the chosen category from the drop-down list. You can select multiple categories for one product.

Category assignment in product view

Classification category

Classification categories can be assigned the same way as the standard ones. When you assign a product to a classification category, the product automatically receives all classification mixins defined for that category and its parent hierarchy. Those mixins add standardized attributes to the product, for example, technical specifications or warranty fields, so the product has a consistent structure and can be validated according to the classification schema.

After you assign a product to a classification category, a new Classification tab appears on the product level. The assignment is only active when the classification category is marked as Published in the Validity tab. If the category is not published, the product cannot be assigned to it.

Product view with Classification category and new tab showing classification mixin

Whenever the mixin schema for the product's classification category changes, you receive a notification and see highlights of what changed. You can keep the old version or switch to the new one. To see these version notifications, you must have the classification mixin schema Saved in the Classification tab in the product view.

Updated product view with new version to review

If the schema is not saved there, the Classification tab in the product view always takes the latest Classification category version automatically.

Updated product view with automatically updated version

To learn how to create classification categories and manage classification mixins, see Classifications.

For mixin schema versioning in the Management Dashboard, see Mixin schema versioning.

4

Choose the product supplier

Choose a supplier, or multiple suppliers, that would be responsible for availability of your product by going to the Suppliers tab and selecting the supplier from the drop-down list.

5

Set up the product pricing

• In the Prices tab, choose the tax configuration for the product: a country and a tax class related to the chosen country.

• After saving the tax configuration, add a pricing model to a product. A pricing model defines a pricing strategy set up for a product together with the product units.

• Additionally, you can define a discount associated with the product, choose the Discount Type:

  • percent - percentage that you want to lower the price by

  • amount - the exact amount that you want to lower the price by

Pricing model

For more information about pricing, see Pricing and Price Model guides.

6

Set up availability information

Set the product's stock levels and distribution channel in the Availability tab. You can choose between three distribution channels:

• Assortment

• Home delivery

• Pickup

The stock level is automatically updated with every order that is placed for the product.

Expand a site row to edit its details. The expanded row has General and Availability Schema tabs. Use Availability Schema to view and save mixin fields for that site availability record.

Availability mixin fields for a site in the product Availability tab

To create an availability mixin schema, see Mixin Schemas.

7

Add product media

Add images to your product by going to the Media tab and uploading new files.

• Select the files, either by the Choose images icon or by using the drag and drop functionality

• Upload the images using the Upload icon

• If you decide not to upload the selected files, use the Clear icon to remove the selection

Media

8

Optional: Link with other products

If you want to connect your product to other products at your store, you can configure linking between the products in the Linked Products tab.

Create a bundle

Create products bundled together.

1

Choose to create a product bundle

In the Add new product choose the Bundle option.

2

Add the required information

Fill in the general tab with mandatory data.

3

Add products to the bundle

Go to the Bundles tab, choose Add bundle products, and select the items you want to include in the bundle.

Adding products to the bundle

4

Save the configuration

You can adjust the quantity of bundled products at any time.

Product bundle

You can set the rest of the bundle configuration the same way as for the basic product. Check out the Create a basic product section.

Create a product variant from a product template

Use a product template to create a parent product and its variants – each with the selected combination of defined variant attributes. This option is useful for fixed, more predictable attribute sets, like size or color.

1

Choose to create the product variant

In the Add new product, choose Variant.

2

Provide the variant data

Add the required general information and choose a product template that has variant attributes defined.

Product variant template

Every variant attribute from the template is then displayed in the product's Attributes & Variants tab.

Product variants

You can set the rest of the variant product configuration the same way as for the basic product. Check out the Create a basic product section.

Create dynamic variant hierarchy

Variant hierarchy is recommended when you need more depth in your product catalog structure and when product dimensions are more likely to change over time. Variant hierarchy allows you to define variant attributes and hierarchy levels on the fly without any predefined product template.

1

Choose to create variant hierarchy

In the Add new product, choose Variant Hierarchy.

2

Define the parent level

You start with the parent product definition. Type in the required general information for the top level product. You can already define the attributes that are inherited by all child variants at all levels.

Creating parent product in variant hierarchy

Prices are not passed to child levels as most frequently variant products do not share the same prices.

3

Build product hierarchy

Once you have the defined parent product, you can build child levels. From the root level in the hierarchy tree, choose the + and Add child to add a variant product definition. From lower levels, you can choose if you want to Add child or Add sibling level. A child inherits all attributes defined in the entire chain. A sibling means that the system creates a copy of the selected product with all its attributes at the same level of inheritance.

Adding a child level variant

Adding a child or sibling level variant

At each hierarchy level, define the properties that constitute a variant level in the Attributes section. Variant attributes are inheritable by child levels and copied over to sibling levels. You can define a flexible attribute model that can help you represent product features in your storefront. You can modify the values when you create a particular level variant.

Variant attributes

• For easier navigation, add a name in the Variant Level Type for the attributes definition, which is displayed in the hierarchy tree.

• Mark the variant as Sellable when the product variant is a unit that can be bought on a storefront and added to cart by customers. Non-sellable variants serve as intermediate groupings of products. Sellable variants are marked with S label in the hierarchy tree. The Sellable setting applies to each variant individually and is not inherited from parent levels.

• The variant attributes can be of the following types:

  • String

  • Number

  • Decimal

  • Boolean

• The attributes you define at a particular level are labelled as Local. The attributes inheritted from higher levels are visible at child variant levels and cannot be removed.

• Sibling levels get a copy of the local attributes, so you can only change their values.

You can add as many inheritance levels as needed. The hierarchy tree displayed on the side allows you easy navigation and modification of each variant.

Building variant hierarchy

You can set the rest of the variant product hierarchy configuration the same way as for the basic product. Check out the Create a basic product section.

Linking products

Linking products to other products can facilitate selling matching accessories, related consumables, or items that your customers might also like to buy together.

In the Management Dashboard, there are Accessory and Consumable types out-of-the-box. You can define a custom type for linking products together through Configuration Service API. To learn how to define custom types, see Creating Client Configuration.

1

Choose the product

In Products view, open a product you want to add related items for.

2

Choose to add linked product

Go to the Linked Products tab and select Add new linked product.

Linked products

3

Browse for the product to link

Select or use search bar to find the product you want to link. This shows you a list of items matching what you type.

Product linking

4

Select the product

To add multiple related items, repeat typing in the relevant product name. Confirm the selected products with Add products.

5

Set up the relation type

Review the list of linked products and select the relevant relation type.

Linked products list

6

Save the product

The product is linked to other products so now they can be displayed together in your online store.

Making products buyable on the storefront

Configuring a product in the steps above is not always enough for customers to add it to the cart on the storefront. In addition to product data, the site must have matching tax, shipping, and currency settings.

On the product level, ensure:

• The product is published and assigned to a category in a catalog published to the site.

• Prices have the tax class, price model, amount, site, currency, and country set.

• Availability has the stock level and distribution channel set for the site.

For how site settings connect to product configuration, see Products on the storefront.

Vendor related products

Whenever a new product is created by a user who is assigned to one of the vendor user groups, the product is visible only for the specific vendor and the permissions related to viewing/managing the product for the users depend on the vendor group they belong to.

It's also possible to assign existing products to a vendor by editing the General tab of the product view.

Vendor products

Updating a product price by vendor

Products available to vendors display the default pricing model to vendor product managers. To change the pricing model for the product:

1

Open the product price details

Choose the product and go to the Price tab, the configuration uses the default price model.

2

Choose the price model

To change the price model choose one that is visible in the drop-down menu.

3

Save your configuration

The newly chosen pricing model is now valid for the specific product.

When a merchant creates a new product, the system always sets the pricing model to the default one.

For more details about vendors, see the following guides:

• Vendor Management

• Vendor Order Split

• Vendor User Groups

• Vendor Service

Audit Logs

The Audit Logs tab shows the history of changes for this product, including what changed and when, with field-level previous and updated values. Actors can include named users, anonymous storefront activity, or system actions.

Product Audit Logs tab

For the tenant-wide audit history, see Audit Logs.