Skip to main content

Creating new items

Have you already configured the preparatory settings? For example, have you create a category structure, sales prices and attributes? Then you’re ready to start entering item data into plentymarkets. This page teaches you how to manually create items and variations.

The procedure is as follows:

Other ways to create items

This page teaches you how to manually create items and variations. This is useful, e.g. if you only want to add a few new products to your assortment.

But what if you want to add several hundred item data records? It would take far too long to do this manually. Take a look at the various tools for importing item information. Choose the tool that is most appropriate for your situation.

1. Requirements

This page assumes that you already have basic knowledge of the item structure in plentymarkets. For example, you should know the difference between items and variations. You should also know that item data can be inherited.

A quick refresher on these topics:

While creating an item, the first variation is automatically created along with it. This variation is the main variation and it is closely tied to the item. The neat thing about the main variation is that its data can be passed on to other variations, i.e. they can inherit its data. As such, the main variation is a parent variation that passes on certain settings to its children.

The inheritance function is activated by default. When a new variation is created, this variation inherits settings from the main variation, as long as no other data is saved.

The following data should be in the system

Furthermore, make sure you’ve saved the following data in your system before you start manually creating items and variations:

2. Creating a new item

Create the item data record by entering some basic information about the product. Don’t worry, you can still modify most of this information after it has been created.

The item will not be available for sale immediately. In other words, your customers will not be able to buy an item that has just been created and is not yet ready to be sold.

This video gives you a playful demonstration of how items are created manually:

Creating a new item

Creating a new item:

  1. Go to Item » Edit item.

  2. Click on New.
    → The New item tab opens. This tab is divided into several areas.

  3. Carry out the settings.

  4. Save () the settings.
    → The item will be created along with the main variation and displayed in a new tab.

Area: Item data
Setting Explanation


What sort of item do you want to create? In most cases, you’ll probably create a “normal item”, i.e. an item of the type Default.

The other options in the drop-down list are intended for other situations:

Note: This setting can no longer be changed once the item has been created.


The item ID is a unique, consecutive number that is used to identify each item in plentymarkets.

Recommendation: We recommend leaving this field blank. This will cause plentymarkets to automatically assign the next free ID. We also recommend that you do not change the ID once the item has been created. Since the ID is linked to many parameters, changing the ID can cause errors.


Who makes this item? Choose the appropriate manufacturer from the drop-down list.

Note: This list only includes the manufacturer data records that you’ve already saved in plentymarkets.

(Mandatory field)

Enter a name for the item.
Once you’ve created the item, you’ll be able to save additional names, e.g. if you want the item to have a different name on marketplaces.


Assign one or two flags to the item.

Use case: You’ll see the flags when you look at your items in the overview. Such visual aids help you find the right items at a glance. You can also search for items that have a specific flag or combination of flags.


Choose Stocked item (default setting), Production item, Colli or Special order item.
Coli = Select if the item is to be shipped in several packages. For additional packages, individual items with the stock type Colli must be created in plentymarkets, but these items should not be activated for the plentyShop.

Area: Variation » Basic settings
Setting Explanation

Variation name

Enter a name for the main variation.

Variation No.

Enter a number for the main variation.

Recommendation: If you leave this field blank, then plentymarkets will automatically assign the next available variation number. The number will be assigned according to the pattern saved in the menu Setup » Item » Settings.

External variation ID

Enter an external variation ID for the main variation.

Use case: The external variation number facilitates importing items and variations from an external system.


Enter a model name for the main variation.

(Mandatory field)

Enter a numerical value and choose a unit from the drop-down list, e.g. 500ml or 150g.

Area: Variation » Category link
Setting Explanation

(Mandatory field)

Which category should the item be sorted into? Click on a category to choose it.

If the item should appear in multiple categories, just choose one of them for now. Once you’ve created the item, you can add the other categories too.

Tip: Click on a category’s folder icon () on the far left. This displays the subcategories within.

Note: This list only includes the categories that you’ve already saved in plentymarkets.
Click on New category if you want to save a new category while creating the item. This method can save you time but it might also cause you to lose track of your category structure.

Area: Variation » Attributes
Setting Explanation

Here you’ll see a list of the attributes that you’ve already created in plentymarkets.

Recommendation: It’s technically possible to select attributes here. However, we don’t recommend this. Rather, we recommend that you first create the new item without any attributes. Afterwards, we recommend that you select attributes while you create the necessary variations.

Why? If you link attributes while creating a new item, then all of the following variations will have to be created from the same attributes too. This is not the case if you wait to link attributes while creating variations. In other words, it makes you much more flexible in the future.

Area: Variation » Sales prices
Setting Explanation

Here you’ll see a list of the sales prices that you’ve already created in plentymarkets. Here you can save a gross price for the main variation:

  1. Choose a sales price from the drop-down list and click on Add ().
    → This moves the sales price down to the list below.

  2. Enter the gross price in the field.

Alternative: Leave this area empty for now and instead, save the price once you’ve created the item. Why? Once you’ve created the item, you can decide whether you want to enter gross or net prices. You can also have the prices be calculated automatically. In other words, it makes you much more flexible in the future.

3. Accessing the item data record in the back end

New items are inactive by default. This prevents customers from buying an item that has just been created and is not yet ready to be sold.

So if you search for a new item data record in the plentymarkets back end, then you will need to change the pre-set search filters so that they include inactive items.

Displaying inactive items in the overview:

  1. Go to Item » Edit item.

  2. Set the filter Active to ALL.

  3. Click on Search ().

4. Creating the necessary variations

Some items like shoes and t-shirts are sold in various sizes and colours. In other words: your customer doesn’t simply buy your t-shirt, but rather a specific variation of your t-shirt, e.g. in the colour red and the size S.

First, create all of the necessary variations.

Creating variations:

  1. Access the item data record if it isn’t already open.

  2. Click on the Variations tab.

  3. Click on New.
    → The Create new variations window opens.

  4. Carry out the settings. Note Table 1.

  5. Click on Create variations.
    → The variations will be created and displayed in the overview.

Table 1. Creating the necessary variations
Setting Explanation


Variations differ from each other in terms of quantity and/or unit.

Example: A bottle of soap that’s available in 100ml, 250ml and 500ml.


  1. Enter the quantity and unit for the first variation, e.g. 100ml.

  2. Click on Create variations.

  3. Repeat the procedure for 250ml and for 500ml.


Variations differ from each other in terms of their attribute values.

Example: A t-shirt that’s available in the colours green or blue and in the sizes S, M or L.


  1. Select the colours and sizes ().

  2. Look at the lower right corner and make sure the number of combinations seems to be correct. For example, if you combine the colours green and blue with the sizes S, M, L, then you will have 6 variations.

  3. Click on Create variations.

5. Adding further product data

At this point, you’ve created the item data record and saved some basic information about it. But you can still add lots of other product information to the data record, e.g.:

6. Looking at the item in the front end

Are you curious what the new product looks like in your plentyShop? See a preview of the item and find out where you need to add further product data or adjust the settings.

Viewing a preview of the item:

  1. Click on Preview () in the toolbar.
    → The Client (store) window opens.

  2. Decide which plugin set and client you want to use when viewing a preview of the item.
    Tip: These settings are preselected next time you click on the preview icon.

  3. Click on Execute.
    → A preview of the item is shown.

7. Putting the item up for sale

Variations are not visible to customers in the plentyShop until they have been activated. In other words, you can work on inactive variations without your customers noticing. You activate the variation when you’re ready for it to be visible in your plentyShop.

Activating a variation:

  1. Go to Item » Edit item.

  2. Search for and open the variation.

  3. Find the Availability area within the Settings tab.

  4. Select the Active option ().

  5. Save () the settings.

Complete checklist for item visibility

Not only do items need to be activated, but they also need to have a price, a category and positive net stock. Otherwise customers wouldn’t be able to buy the item.

Work through this checklist and make sure your item meets all of the requirements for being visible in the plentyShop. This checklist helps you find any possible errors that are preventing your items from being displayed.

To top