The import function allows you to quickly add or update product and offer information. All content and offer fields can be filled via an import.
Upload File
Click the plus sign at the bottom right of the import page to upload a file. The file types .XLSX (Excel), .CSV, .XML, .TXT, .JSON, or a URL (Feed) are supported in the import function.
Upload the file by dragging it there or click 'Choose File' to select the desired file.
For importing an Amazon or Bol content export, we have developed a conversion mode. This makes mapping the fields in the following steps easier. When importing one of these files, choose the Amazon or Bol conversion mode.
Note! This conversion mode only works with a content export that comes directly from Amazon or Bol and has not been edited afterward.
By clicking upload, the file is added. You can then start setting up and mapping the import file.
Step 1 Options
In step 1, you set the import and file settings.
Import Name
This is the name of the import run. Enter a recognizable name here. By default, we use the file name.
Import Mode
There are three import options available;
1. Create and Update
Products not yet known in ProductFlow are newly created. Existing products already known in ProductFlow are updated.
This is based on the selector selected (step 2).
2. Create Only
Only products not yet known in ProductFlow are newly created.
Nothing is done with products already known in ProductFlow.
This is based on the selector selected (step 2).
3. Update Only
Only products already known in ProductFlow are updated.
New products not yet known in ProductFlow are not imported or created.
Base Product
It is possible to select a base product. All new products are created with the information from the selected base product.
Read here more about using base products.
Unique Columns
It may happen that multiple columns in the import file have the same column name. By setting Unique Columns to 'yes', the mappings are automatically applied to all columns with the same column name.
This means you only need to map the column once, and it will be automatically applied to all columns with that name.
Suggestions for Mapping Sales Channels
Select the sales channels for which you need mapping suggestions. By minimizing the number of sales channels you select, the performance and accuracy of the suggestions are optimized.
Example:
If you select Bol NL here, you will receive mapping suggestions for Bol NL fields when mapping the columns.
Only Fields for Sales Channels
When enabling this setting, fields for the basic content are excluded from the mapping process. This means that only sales channel-specific fields can be mapped.
Default Language
Select the language for which you want to import the fields.
Default Currency
Select the currency for which you want to import the fields.
Default Separator
Select the separator used in the import file. This refers to the separator used in one column, where multiple contents are present, which should be imported separately.
Example:
Image1>Image2>Image3
Separator = >
Tip! You don't necessarily have to choose a separator from the dropdown. It's also possible to enter one yourself. Do this by typing the desired separator and then clicking it in the dropdown.
Ignore Duplicate SKUs
With this setting, all duplicate SKUs from the import file are ignored. Use this setting only when importing content for family products; in other situations, this is not desirable!
Read here how to import content for families.
Sheet Configuration
Indicate what the header in the file is. Do this by selecting the dot next to the header.
Additionally, you have the option to ignore tabs. This is only possible if the import file consists of multiple tabs.
Select the tab and choose 'Ignore tab' if you want to ignore the selected tab. This tab will not be included during the import. All information on the ignored tab cannot be mapped.
Step 2 Selectors
All information is updated or created based on the selector. The selector ensures that the product or offer information ends up with the correct product. An SKU or EAN is often selected here.
Note! If you want to create new products, an SKU is required.
In the dropdown under 'Column', select the column from the import file. You then map this to a ProductFlow selector field.
When selecting the SKU mapping, you have the option to select a conversion. This is only used if you want to use the EAN as an SKU. When you choose 'Convert to EAN13', the EAN is converted to a valid 13-digit EAN. The outcome depends on the type of EAN; in some cases, leading zeros are added, and in others, a number combination.
Step 3 Mappings
In this step, you map all columns to a ProductFlow field. The content of the column is placed in the mapped field after importing.
Column
Below you will find all columns from the import file. The header is shown as selected in step 1. It is possible to search for a column by entering the column name in the search bar.
Values
Here, the first three values from the column are shown.
If there are no values in a column, that column will be excluded from the mapping process.
Mapping
Select the desired mapping from the dropdown. Depending on the settings configured in step 1, both basic and sales channel-specific fields will be displayed here. In some cases, a mapping suggestion is already filled in.
Note! The mapping (suggestion) must always be saved. You do this by clicking the save icon.
It is possible to select multiple mappings for one column. You do this by clicking the plus sign next to the mapping dropdown, after which an additional dropdown will appear. You can then select a new mapping in this dropdown.
This way, it is possible to map the information from one column to multiple different ProductFlow fields.
Representation
Only applicable to information that requires a unit, such as dimensions, weights, and prices. The representation is set to automatic detection by default. For prices, we use the default currency from step 1. For dimensions and weights, automatic detection only works if a unit is in the same column as the value, for example, 5 g or 5 grams. When the value and the unit are in two separate columns, automatic detection does not work, and you must enter a manual representation.
Language
The default language from step 1 is automatically applied to all mappings where a language is applicable. It is possible to change the language per mapping by selecting a different language in the dropdown.
Delimiter
The default delimiter from step 1 is automatically applied to all mappings where a delimiter may be applicable. It is possible to change the delimiter per mapping by selecting/filling in a different delimiter in the dropdown.
Mappings can be 'removed' by clicking the cross. Each mapping must still be saved. Once a mapping is saved, it disappears under the 'Mapping' tab and appears under the 'Mapped' tab.
Mapped
All saved mappings are under the 'Mapped' tab. Here you can see at a glance which fields are mapped and will be filled from the import. You also have the option to undo a mapping. You do this by clicking the arrow next to the mapping. The mapping will be 'removed,' and the field will return to the 'Mapping' tab, where you can attach a different mapping to it. Additionally, from the 'Mapped' page, you also have the option to add an extra mapping to a field that is already mapped. You do this by clicking the plus sign next to the mapped field. An extra dropdown will appear where you can add a new mapping.
Step 4 Review
After the desired fields are mapped, the import file is analyzed. Depending on the file size and the number of mapped fields, this may take a while.
After analyzing, a (possible) error report is generated.
Errors
All products with an Error message will be completely skipped during import. These products will not be created/updated.
Warnings
Only the fields/mappings where the Warning message applies will be skipped during import. The other fields, where there is no message, will be imported as usual.
Messages
Here, general Messages about a product and/or field/mapping are displayed. The products and fields/mappings will be imported as usual.
By clicking the Error messages with content button, you download the error report in the form of a .CSV file. This provides an overview of all products from the import file, including the associated content and error message. Based on this file, you have the opportunity to resolve the error messages and re-import the file.
Important, the file has not yet been actually imported at this step. This only happens after you click the import button in the bottom right corner.
Depending on the file size and the number of mapped fields, importing may take a while.
Tip! We recommend always importing images separately. These are often heavier mappings, and if you combine this mapping with multiple other mappings in one import run, it may take longer.
Step 5 Report
After importing, the import runs are displayed in step 5.
Run
Here, the date and time of import are displayed. This is the moment when the import button was clicked in step 4.
User
Here, the name of the user who performed the import run is displayed.
Total number
Here, the number of products that have been updated/created is displayed.
Content changes
Here, the number of content changes per import run can be seen. When you click here, you will see all changes per product. From this page, it is also possible to undo the changes.
Note! This is currently only possible with content changes; offer changes from the import cannot be undone.
Number failed
Here, a tally of all products that were not imported is displayed. These are often the same products that received an error message in step 4 (review). These products were not imported. Click on the number of messages to see which products are involved.
Number of warnings
Here, a tally of all fields/mappings that were not imported is displayed. These are often the same products that received a warning message in step 4 (review). These fields/mappings were not imported. Click on the number of messages to see which fields are involved.
Number of messages
Here, a tally of all products with a message is displayed. These are often the same products that received a message in step 4 (review). Click on the number of messages to see which products are involved.
Status
Here you can see whether the import run was successful or not.
Checkmark = Successful import run
Exclamation mark = There are products skipped during import (errors)
Filter by import run
From the product overview, it is possible to filter by an import run. As a result, all products from the import run will be displayed.
Import tips
Check out this article for tips on importing specific information or files.