Categories
This page explains the matching and mapping fields that you can use while importing categories. This page serves purely as a reference and it assumes that you already have a basic understanding of the import tool.
Practical example: Importing new categories
Imagine you’re new to plentymarkets and you want to import all of your category data at once. How would that work? Take a look at this practical example, which guides you through the process step-by-step. |
1. Matching fields
Table 1 explains the fields that are available for matching category data. During the import, plentymarkets checks if the imported data record already exists based on the matching field.
Setting | Explanation |
---|---|
Category ID |
Which column of your CSV file lists the category IDs? Choose this column here. This option is useful if you want to update existing categories. Background info: Every new category automatically receives an ID, which can not be changed. The ID is used to uniquely identify the category. Since the ID is unique, it’s a good way to check whether the imported data record already exists in plentymarkets. |
Combined category name |
Which column of your CSV file contains the complete category path? Choose this column from the first drop-down list and choose the separator from the second drop-down list. This option is useful if you want to create new categories. |
Category name level 1 - 6 |
Which column of your CSV file contains the category name for this level? Choose this column here. |
2. Mapping fields
This chapter explains the fields that are available for mapping category data. Use these fields to specify which column of your file corresponds to which data field in your system.
Basic procedure:
-
In your CSV file: Enter a valid import value into a column.
-
In plentymarkets: Assign this column to the appropriate mapping field.
-
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 category will be given the default value. |
2.1. Category
2.1.1. Parent category ID
Enter the higher-level category ID in your CSV file. This tells plentymarkets how the categories relate to each other. For example, whether a row of the CSV file should be interpreted as a subcategory and if so, which category is above it.
Default value: No default value
Permitted import values: Numeric (internal category ID)
2.1.2. Parent category name
Enter the higher-level category name in your CSV file. This tells plentymarkets how the categories relate to each other. For example, whether a row of the CSV file should be interpreted as a subcategory and if so, which category is above it.
Default value: No default value
Permitted import values: Alpha-numeric
2.1.3. Type
What do you want to use the category for? In plentymarkets, categories can be used to group products together or to create content pages for your store.
Default value: item
Permitted import values in CSV file | Options in the drop-down list in the back end |
---|---|
|
Item |
|
Container |
|
Content |
|
Blog |
You can find the result of the import in the back end menu: Item » Category » Tab: Settings » Drop-down list: Type
2.1.4. In link list
Decide whether the category should be displayed in the online store’s navigation.
Default value: 0
Permitted import values in CSV file | Options in the drop-down list in the back end |
---|---|
|
Do not display |
|
Display |
You can find the result of the import in the back end menu: Item » Category » Tab: Settings » Drop-down list: In link list
2.1.5. right
Decide whether the category should only be visible for users who have logged in.
Default value: all
Permitted import values in CSV file | Options in the drop-down list in the back end |
---|---|
|
Public |
|
After login |
You can find the result of the import in the back end menu: Item » Category » Tab: Settings » Drop-down list: Visible
2.1.6. Visible
Decide whether the category should be included in the sitemap.
Default value: 0
Permitted import values in CSV file | Options in the drop-down list in the back end |
---|---|
|
Do not display |
|
Display |
You can find the result of the import in the back end menu: Item » Category » Tab: Settings » Drop-down list: Sitemap
2.1.7. Delete category
Do you want to delete the category?
Default value: 0
Permitted import values in CSV file | Result in the back end |
---|---|
|
Category will not be deleted |
|
Category will be deleted |
2.1.8. Create parent category if not found
Do you want to create the category directly above it, if this category doesn’t already exist?
Default value: 0
Permitted import values in CSV file | Result in the back end |
---|---|
|
Parent category will not be created |
|
Parent category will be created |
2.2. Category settings
2.2.1. Name
Required field
Enter the category name into the CSV file.
Default value: No default value
Permitted import values: Alpha-numeric
Also use the drop-down lists to select the language and the webstore. |
You can find the result of the import in the back end menu: Item » Category » Tab: Settings » Entry field: Name
2.2.2. Description 1
Enter the category description into the CSV file.
Default value: No default value
Permitted import values: Alpha-numeric
Also use the drop-down lists to select the language and the webstore. |
You can find the result of the import in the back end menu: Item » Category » Tab: Description 1
2.2.3. Description 2
Enter the category description into the CSV file.
Default value: No default value
Permitted import values: Alpha-numeric
Also use the drop-down lists to select the language and the webstore. |
You can find the result of the import in the back end menu: Item » Category » Tab: Description 2
2.2.4. Short description
Enter the short description into the CSV file.
Default value: No default value
Permitted import values: Alpha-numeric
Also use the drop-down lists to select the language and the webstore. |
You can find the result of the import in the back end menu: Item » Category » Tab: Settings » Entry field: Short description
2.2.5. Meta keywords
Enter keywords into the CSV file.
Default value: No default value
Permitted import values: Alpha-numeric
Also use the drop-down lists to select the language and the webstore. |
You can find the result of the import in the back end menu: Item » Category » Tab: Settings » Entry field: Meta keywords
2.2.6. Meta description
Enter a meta description into the CSV file.
Default value: No default value
Permitted import values: Alpha-numeric
Also use the drop-down lists to select the language and the webstore. |
You can find the result of the import in the back end menu: Item » Category » Tab: Settings » Entry field: Meta description
2.2.7. Meta title
Enter a meta title into the CSV file.
Default value: No default value
Permitted import values: Alpha-numeric
Also use the drop-down lists to select the language and the webstore. |
You can find the result of the import in the back end menu: Item » Category » Tab: Settings » Entry field: Meta title
2.2.8. URL name
Enter a URL name into the CSV file. This name is used to form the category URL.
Default value: URL name = Category name
Permitted import values: Alpha-numeric
Also use the drop-down lists to select the language and the webstore. |
You can find the result of the import in the back end menu: Item » Category » Tab: Settings » Entry field: URL name
Example: The URL name new-category
will transform into the URL www.your-domain.com/new-category
2.2.9. Position
Enter a position number in the CSV file.
Default value: 0
Permitted import values: Numeric
Also use the drop-down lists to select the language and the webstore. |
You can find the result of the import in the back end menu: Item » Category » Tab: Settings » Entry field: Position
2.2.10. Template list
Only relevant for the old Callisto store
Enter the name of the template into the CSV file.
Default value: ItemViewCategoriesList
Permitted import values: Alpha-numeric
Also use the drop-down lists to select the language and the webstore. |
You can find the result of the import in the back end menu: Item » Category » Tab: Settings » Drop-down list: Template list
2.2.11. Template product
Only relevant for the old Callisto store
Enter the name of the template into the CSV file.
Default value: ItemViewSingleItem
Permitted import values: Alpha-numeric
Also use the drop-down lists to select the language and the webstore. |
You can find the result of the import in the back end menu: Item » Category » Tab: Settings » Drop-down list: Template product
2.2.12. Template page
Only relevant for the old Callisto store
Enter the name of the template into the CSV file.
Default value: PageDesignContent
Permitted import values: Alpha-numeric
Also use the drop-down lists to select the language and the webstore. |
You can find the result of the import in the back end menu: Item » Category » Tab: Settings » Drop-down list: Template page
2.2.13. Full text search
Decide whether the category should be added to the store’s category search index.
Also use the drop-down lists to select the language and the webstore. |
Default value: 0
Permitted import values in CSV file | Options in the drop-down list in the back end |
---|---|
|
No |
|
Yes |
You can find the result of the import in the back end menu: Item » Category » Tab: Settings » Drop-down list: Full text search
2.2.14. Robots
Decide how search engine crawlers should deal with the page and any links on the page.
Also use the drop-down lists to select the language and the webstore. |
Default value: all
Permitted import values in CSV file | Options in the drop-down list in the back end |
---|---|
|
all |
|
index |
|
nofollow |
|
noindex |
|
nofollow, noindex |
You can find the result of the import in the back end menu: Item » Category » Tab: Settings » Drop-down list: Robots
2.2.15. Translate placeholder
Decide whether template variables and template functions should be translated.
Also use the drop-down lists to select the language and the webstore. |
Default value: Y
Permitted import values in CSV file | Options in the drop-down list in the back end |
---|---|
|
Yes |
|
No |
|
Template variables and template functions for links only |
You can find the result of the import in the back end menu: Item » Category » Tab: Settings » Drop-down list: Translate template variables and template functions
2.2.16. Canonical
Is there another category with the same content? If so, then enter the URL for this category into your CSV file. The URL is limited to a maximum of 256 characters. This prevents so-called “duplicate content”.
Default value: No default value
Permitted import values: Alpha-numeric
Also use the drop-down lists to select the language and the webstore. |
You can find the result of the import in the back end menu: Item » Category » Tab: Settings » Entry field: Canonical
2.3. Elmar
2.3.1. Elmar-category
Enter the name of the Elmar category into your CSV file.
Default value: No default value
Permitted import values: Alpha-numeric
Also use the drop-down list to select the webstore. |
You can find the result of the import in the back end menu: Item » Category » Tab: Settings » Drop-down list: Elmar category
2.3.2. Delete existing
Do you want to delete the Elmar category link?
Default value: 0
Permitted import values in CSV file | Result in the back end |
---|---|
|
Link will not be deleted |
|
Link will be deleted |
Also use the drop-down list to select the webstore. |
2.4. Client (store)
2.4.1. Active
Should the category be activated for a particular store?
Also use the drop-down list to select the webstore. |
Default value: 0
Permitted import values in CSV file | Result in the back end |
---|---|
|
Not activated for the specified client. |
|
Activated for the specified client. |
You can find the result of the import in the back end menu: Item » Category » Tab: Settings » Check box: Client (store)