Skip to main content

Attribute

This page explains the matching and mapping fields that you can use while importing attributes and attribute values. This page serves purely as a reference and it assumes that you already have a basic understanding of the import tool.

1. Matching fields

Table 1 explains the fields that are available for matching attribute data. During the import, plentymarkets checks if the imported data record already exists based on the matching field.

Table 1. Matching fields for importing attributes
Setting Explanation

Attribute ID

Which column of your CSV file lists the attribute IDs? Choose this column here. This option is useful if you want to update existing attributes.

Background info: Every new attribute automatically receives an ID, which can not be changed. The ID is used to uniquely identify the attribute. Because the ID is unique, it’s a good way to check whether the imported data record already exists in plentymarkets.

Attribute value ID

Which column of your CSV file lists the attribute value IDs? Choose this column here. This option is useful if you want to update existing attribute values.

Background info: Every new attribute value automatically receives an ID, which can not be changed. The ID is used to uniquely identify the attribute value. Because the ID is unique, it’s a good way to check whether the imported data record already exists in plentymarkets.

Attribute name

Which column of your CSV file lists the internal attribute name? Choose this column here. This option is useful if you want to create new attributes.

Attribute value name

Which column of your CSV file lists the internal attribute value name? Choose this column here. This option is useful if you want to create new attribute values.

External attribute name

Which column of your CSV file lists the external attribute name? Choose this column from the first drop-down list and choose the language from the second drop-down list.

External attribute value name

Which column of your CSV file lists the external attribute value name? Choose this column from the first drop-down list and choose the language from the second drop-down list.

2. Mapping fields

This chapter explains the fields that are available for mapping attribute data. Use these fields to specify which column of your file corresponds to which data field in your system.

Basic procedure:

  1. In your CSV file: Enter a valid import value into a column.

  2. In plentymarkets: Assign this column to the appropriate mapping field.

  3. After the import: Check the result in the back end.

No mapping field? Default value applies!

If you don’t include a certain piece of information in your CSV file, i.e. if you don’t use a certain mapping field, then your attribute will be given the default value.

2.1. Attribute

2.1.1. Name (internal)

Required field for creating new attributes

Enter the attribute’s internal name into the CSV file. The internal name is used in the plentymarkets back end only and is not visible for the customers.

Default value: No default value

Permitted import values: Alpha-numeric

You can find the result of the import in the back end menu: Setup » Item » Attributes » Tab: Basic settings » Entry field: Name (internal)


2.1.2. Position

Enter a position number in the CSV file.

Default value: 0

Permitted import values: Numeric

You can find the result of the import in the back end menu: Setup » Item » Attributes » Tab: Basic settings » Entry field: Position


2.1.3. Image link possible

Should the item image change, e.g. on eBay, depending on which size or colour a customer chooses? In other words, should the appropriate images automatically be displayed on eBay?

Enter your choice into the CSV file.

Default value: 0

You can find the result of the import in the back end menu: Setup » Item » Attributes » Tab: Basic settings » Check box: Image link possible

Additional settings: Link your variations to the appropriate images. Make sure that you’ve made these images available for the marketplace. Then link the variation images to the market attributes. These steps are described in further detail in another chapter.


2.1.4. Attribute selection in store

How do you want customers to choose sizes or colours in your store? Should they choose the name from a drop-down list or click on an image?

Enter your preferred method of selection into the CSV file.

Default value: dropdown

Permitted import values in CSV file Options in the drop-down list in the back end

dropdown

With drop-down menu

image

With image

box

With box


2.1.5. Groupable in item lists

Should variations that have this attribute be displayed individually or cumulatively in the online store?

Enter your choice into the CSV file.

Default value: 0

Permitted import values in CSV file Result in the back end

0

No. Check mark is not placed. The variations will be displayed cumulatively in the online store.

1

Yes. Check mark is placed. Each variation will be displayed as an individual product in the online store.

You can find the result of the import in the back end menu: Setup » Item » Attributes » Tab: Basic settings » Check box: Groupable in item lists


2.1.6. Delete attribute

Do you want to delete the attribute?

Default value: 0

Permitted import values in CSV file Result in the back end

0

Attribute will not be deleted

1

Attribute will be deleted


2.2. Value

2.2.1. Name (internal)

Required field for creating new attribute values

Enter the attribute value’s internal name into the CSV file. The internal name is used in the plentymarkets back end only and is not visible for the customers.

Default value: No default value

Permitted import values: Alpha-numeric

You can find the result of the import in the back end menu: Setup » Item » Attributes » Tab: Values » Entry field: Name (internal)


2.2.2. Position

Enter a position number in the CSV file.

Default value: 0

Permitted import values: Numeric

You can find the result of the import in the back end menu: Setup » Item » Attributes » Tab: Values » Entry field: Position


2.2.3. Note

Enter an optional note about the attribute value into your CSV file.

Default value: No default value

Permitted import values: Alpha-numeric

You can find the result of the import in the back end menu: Setup » Item » Attributes » Tab: Values » Entry field: Note


2.2.4. Percentage

Enter a percentage for the automatic distribution of attribute values.

Default value: 0

Permitted import values: Numeric

You can find the result of the import in the back end menu: Setup » Item » Attributes » Tab: Values » Entry field: Percentage


2.2.5. Delete attribute value

Do you want to delete the attribute value?

Default value: 0

Permitted import values in CSV file Result in the back end

0

Attribute value will not be deleted

1

Attribute value will be deleted


2.3. Attribute name

2.3.1. Name

Enter the attribute’s external name into the CSV file. This is the name that’s displayed in the online store.

Default value: If you don’t enter an external name, then the internal name will be used instead.

Permitted import values: Alpha-numeric

Also use the drop-down list to select the language.

You can find the result of the import in the back end menu: Setup » Item » Attributes » Tab: Name


2.4. Attribute value name

2.4.1. Name

Enter the attribute value’s external name into the CSV file. This is the name that’s displayed in the online store.

Default value: If you don’t enter an external name, then the internal name will be used instead.

Permitted import values: Alpha-numeric

Also use the drop-down list to select the language.

You can find the result of the import in the back end menu: Setup » Item » Attributes » Tab: Values » Entry field: Name

To top