Units

Units such as kilograms, litres and centimetres help you define the size or dimensions of your products. There are 52 units saved according to their ISO code in PlentyONE by default. First, take a look at the existing units. You can create new units or edit the existing units as needed.

1. Creating new units

Units help you define the size or measurements of your products. There are 52 units saved according to their ISO code in PlentyONE by default. However, you can create additional units of measure as needed.

  1. Go to Setup » Item » Units.

  2. Click on .
    → A pop-up window opens. This window is divided into several steps.

  3. Carry out the settings in each step.

Units can not be created via import

Units can only be created manually, as described here in the instructions. It is not possible to create units with the import tool.

Step: Name and Unit of measurement

Setting Explanation

Unit name
(Mandatory field)

Enter a name for the unit.

Note: This text will be visible to customers in the plentyShop.

Unit of measurement
(Mandatory field)

Select a unit of measure according to its ISO code.

Note: You can only choose from the existing ISO codes. You can not manually add new ISO codes.

Step: Optional

Setting Explanation

Position

Enter a position number for the unit.

Example of use: Units can be displayed in the back end, e.g. sorted by their position number.

Decimal numbers

Should decimal numbers be allowed for this unit of measure?

Example of use: For example, half a litre makes sense. But half a container would not make sense.

Step: Done

Setting Explanation

Summary

Here you can see a summary of the settings that you selected. Click on Create unit if you are satisfied with the settings.

Afterwards, you will have the following options:

To the unit

The pop-up window will close and the newly created unit will open for further editing.

Create another unit

The pop-up window will re-start for the next unit.

Close

The pop-up window will close.
To the unit: which advanced settings are available?
Setting Explanation

ID

The unit ID is automatically assigned and cannot be changed. It is used to uniquely identify your units.

Use case: Unit links can be imported. For example, while you import item and variation data, you can also directly link the appropriate units. This is done, e.g. by specifying the unit ID.

Name DE
Name FR
Name IT
etc.

Is your plentyShop available in multiple languages? The variation’s content and unit is visible to customers in the plentyShop, e.g. 1 piece, 500 grams, 2.4 litres, etc. If your online store is available in multiple languages, then the unit names should also appear in these languages.

  1. Click on and select a language version from the drop-down list.

  2. Enter a translation of the name.

2. Finding existing units

Use the search function to find existing units and edit them further.

  1. Go to Setup » Item » Units.

    1. Option 1: Click on to see a list of all units.

    2. Option 2: Enter a number or text into the search field and click on one of the automatic suggestions. Then click on to start the search.

    3. Option 3: Click on tune to narrow down the search results with filters. See the table below.

Table 1. Search filters
Filter Explanation

ID

Enter the ID of a unit.

Note: The unit ID can not be changed. It serves to uniquely identify a unit. This search field is useful if you want to find a specific unit.

Units of measure (ISO)

Select an ISO code from the drop-down list.

Position

Enter the position number of a unit.

Name

Enter the name of a unit.

Note: This is a fuzzy search. The search results will also include units whose names are similar to the text that you entered.

Example: If you enter "gram", then the search results will also include the units "kilogram" and "milligram".
Table 2. Control elements
Element Explanation

Resets the selected filter criteria.

SEARCH

Starts the search.
Filter settings can be saved

When you start a search, your search settings are displayed up top as so-called “chips”. You can save these search settings to apply them again more quickly and easily in the future.

Saving the current filter:

  1. Start a search.

  2. Click on Saved filters (bookmarks).

  3. Click on bookmark_border Save current filter.

  4. Enter a name and toggle the optional settings as needed (toggle_on).

  5. Click on Save.
    → The filter settings now appear under Saved filters (bookmarks).

Element Explanation

Set as default

toggle_on = When you open the menu Setup » Item » Units, the filter settings will already be selected and the search will automatically start with these settings.

toggle_off = The filter settings will not already be selected.

Create filter for all users

toggle_on = The filter preset will be visible for all user accounts.

toggle_off = The filter preset will only be visible for your own user account.

Applying saved filters:

  1. Click on Saved filters (bookmarks).

  2. Click on an existing filter preset.
    → The search is started and the search settings are displayed up top as so-called “chips”.

When you start the search, you’ll see the results in an overview.

  • Option 1: Click on a unit to open it and edit its settings further.

  • Option 2: Select multiple units () and click on the pencil icon (). This opens all of the selected units at once and you can edit their settings further.

3. Specifying the unit and content of your variations

Once you have finished initially configuring the units, you can link them to variations. This can be done manually or via import.

Manually

If you only want to specify the content for a few variations, then it makes sense to do this manually.

  1. Go to Item » Edit item » [Open variation] » Tab: Settings » Area: Dimensions » Option: Content.

  2. Enter a number into the field on the left.

  3. Select a unit from the drop-down list on the right.

  4. Save () the settings.

Import

If you want to specify the content for lots of variations, then it makes sense to do this via import.

  1. Go to Data » Import.

  2. Create a new import of the type Item.

  3. Use the mapping fields:

Further information about the import tool in general.

4. Combining units to generate variations

You can create variations by combining units with different quantities. Example: A bottle of soap that’s available in 100ml, 250ml and 500ml.

  1. Go to Item » Edit item » [Open item] » Tab: Variations.

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

  3. In the Content field, enter the quantity and unit for the first variation, e.g. 100ml.

  4. Click on Create variations.

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

5. Displaying the unit price on sales channels and labels

Surely you’ve seen an item’s unit price displayed on a store shelf. The unit price tells you how much the item costs per kilogram, litre or other unit of measure. It’s calculated based on the variation’s unit, content and price.

Background info: A new regulation on specifying prices went into effect on May 28th, 2022. § 4 states that sellers, who offer products based on weight, volume, length or area, are required to indicate the unit price. The unit price must be specified per 1 kilogram, 1 litre, 1 cubic metre, 1 metre or 1 square metre.

What sellers need to do:

The unit price can be displayed in the plentyShop, on sales channels like Amazon and eBay or on item labels.

plentyShop

  1. Go to Item » Edit item » [Open variation] » Tab: Settings » Area: Dimensions » Option: Content.

    • Make sure that a numerical value was entered and that an option was selected from the drop-down list.

  2. Go to Item » Edit item » [Open variation] » Tab: Settings » Area: Sales prices.

    • Make sure that a price was entered.

  3. Go to Shop » ShopBuilder » [Open content]

    • Make sure that the widget Item / Item price is included in the layout.

According to § 5 of the regulation on specifying prices, the unit price must be specified per 1 kilogram or 1 litre. But that doesn’t mean that you can only enter kilograms or litres into the PlentyONE back end. You can also enter grams or millilitres. PlentyONE will convert the values into kilograms or litres and display the result in the plentyShop. Example: A variation that has a unit price of 1.20 EUR / 100 gram will automatically be displayed as 12 EUR / kilogram in the plentyShop.
Sales channels

Refer to the following pages of the manual for instructions on displaying the unit price on a marketplace:

Item labels

You’ll design your labels with the help of templates. Each template includes information about the size of the label, which data should be displayed on the label and where each piece of data should be positioned on the label.

  1. Go to Setup » Item » Labels.

  2. Expand the template ().

  3. Find the field Unit price and make sure that X/Y coordinates were entered here.

Further information about designing labels.