Exporting and Importing Items

It is easy to create items by adding them in the Back Office. But you can also import them through a CSV file at the Back Office.

To import your items smoothly and quickly, the correct sheet should be prepared. You can download the template, but the best way is to create sample items in the ‘Item list’, export them as a CSV file, and add all the rest of the items to the sheet.

Let’s start by adding a few sample items in the Back Office. Open ‘Item list’.

Go to item list


Add the types of items that you are going to use in your store: composite items, items with variants, or just ordinary items. Fill in the parameters you are going to use with your items: track stock, in stock, low stock notification, price, cost, etc.

Add categories, modifiers, and taxes and apply them to your items. If you have several stores, do not forget to add these stores in the Back Office and set the item’s availability for each store.

When you have a list of sample items, you can export them. Click on the ‘Export’ button.

the ‘Export’ button

Open your CSV file (the best way is to open it from Google Sheets, but you can also use other tools). You will see the sheet with your sample items. You can use it to add other items you intend to import. Follow the pattern of your sample items when filling in the fields.

CSV file

Note: CSV (comma-separated values) format is where the fields are separated by commas, so avoid commas in your data.
For fields with money value, such as ‘Price’ and ‘Cost’, use only numbers - no currency symbols. The decimal separator must be a point.

Features of different types of items

There are some specific points you have to pay attention to when adding data for each type of items: ordinary items, composite items, items with variants, and multistore.

Ordinary items

Ordinary items in export file

Ordinary items - items that are not composite and does not have variants.
For items without variants, it is better to leave the ‘Handle’ field blank in the importing file. In this case, the system will automatically generate unique handles for the new items.

‘SKU’ is an obligatory field and should be unique for each item. The ‘Name’ is also an obligatory field.

Also, leave the columns of ‘Option name’ and ‘Option value’ blank because they are for variants of items.

Leave the column ‘SKU of included item’ blank because it is only for composite items.

Multiple stores

In case of you have multiple stores, you will have the following columns for each store: Available for sale, Price, In stock, and Low stock. Each of the 4 columns will have the store's name in brackets next to it. For example, Available for sale [The Coffee] and Available for sale [Store 2]. So, you can set the values of these parameters for each of your stores.

Multiple stores export file

Items with variants

Items with variants export file
You can see that each combination of a variant in the export file is displayed as a separate item with its own SKU. Follow this pattern as a guideline for your items with variants.
The ‘Handle’ field is required for items with variants and it should be the same for all variants of the same item.

Only the fields of the first item with variants have values. The fields that are common to all variants of the same item are left blank. You may also fill them with the same value, but if they have a different value, you will get an error message when importing.

There are three columns each for ‘Option name’ and ‘Option value’. If some products have less than 3 options of variants, the extra fields are left blank.

Composite items

Composite items export file
Each composite item includes several components. Specify SKU codes of all the included items (components) of the selected composite item in the field ‘SKU of included item’ on a separate row.
‘Quantity of included item’ - in this field, it's necessary to specify the quantity of the component that is included in one unit of the composite item.
You cannot track stock of composite items, so leave the fields that are related to stocks blank. Also, leave all the other fields of components blank except for the first row.


Import of items

Click on the ‘Import’ button.

Importing and exporting items

In the IMPORT menu, choose your CSV file from your computer and click ‘Upload’.

Importing and exporting items

If you filled in the table without errors, you will be directed to an import confirmation window. There, you will see information on how many items and categories will be created or edited. Click 'CONFIRM IMPORT'.
You will see a notification message that the list of items has been successfully updated. Click 'OK' and continue your work.

Import errors
You may be faced with some errors when uploading the completed file. An error message will appear if:

  • You changed the file format so that the file you are trying to upload is no longer in CSV format.
  • The size of your file exceeds the admissible 5 MB.
  • You edited names of columns that should have been left unedited.
  • You have more than 10,000 items saved in your file.

In the next stage, you may be faced with import errors. In this case, the window with the corresponding message will open.

The critical errors are marked with a red sign. Each error has its explanation message and the place of the error: row, column, and cell. Fix all critical errors in the file and try to import the file again.
Warning messages have yellow signs. They are just for your information, and they will not stop your file from being imported.

Importing and exporting items


The meaning of columns

A handle is an item identifier, which should be unique for each item. The ‘Handle’ field should be the same for all variants of the same item.

SKU (Stock Keeping Unit) is a unique code given to each of your items. Specify and fill in each field individually. We recommend using the format '10001', '10002'... etc. but the key point is that no numbers are repeated. One last condition is that the SKU should not exceed 40 characters.

Fill in the names of each imported item in this field. You can use letters, digits, spaces, and any special symbols, as long as you use no more than 64 total characters.

A category is a group to which an item belongs. For example, if you create the items 'Cherries', 'Apples', and 'Oranges', then you can put them into the 'Fruits' category.

Cost is the amount of money you paid to purchase the item. Here, specify the cost of the items only using digits - no currency symbols. Do not fill in the cost field for composite items. This will be calculated automatically as a sum of costs for each individual component.

In this field, fill in the price at which you plan to sell the items. As with the 'Cost' field, enter only digits without currency symbols. If you want to specify the item price during a sale, leave this field empty.

Available for sale
Here, it's only necessary to specify one character: 'Y' (Yes) – if the item is available for sale, or 'N' (No) – if it is not available.
It is important to note that if you ignore this field, then the item will be available for sale by default.

Sold by weight
If the item is sold by weight, enter 'Y' in the field, and if not, enter 'N'. Again, if you do not fill in this field, the item will be sold by weight as default.

Option 1, 2, 3 name
These fields are for option names of the variants. Leave them blank for items without variants.

Option 1, 2, 3 value
These fields are for option values of the variants. Leave them blank for items without variants.

If a barcode is available, then fill in this field with the item's barcode digits.

SKU of included item
Each composite item includes several components. Specify SKU codes of all the included items (components) of the selected composite item here. Leave blank for non-composite items.

Quantity of included item
In this field, it's necessary to specify the quantity of the component that is included in one unit of the composite item. For example, for one portion of the composite item 'Americano with milk', you use 0.1L of the item 'Milk'. This means you should fill in the value 0.1 in the 'Quantity of included item' field nearby 'Milk'.

Track stock
If you would like to track the inventory of a selected item, enter 'Y' in the field and if not, enter 'N'. If you leave this field empty, then it will not track the inventory of that item.

In stock
If you would like to track inventory, then fill in an item's current quantity in this field, again only using digits. To avoid confusion with units (e.g., weight), we advise specifying them in brackets nearby the item name in the 'Name' field. For example, if you have 100 kg of potato in stock, then write 'Potato (kg)' in the 'Name' field and ‘100' under 'in stock'.
If you have selected the option 'Track stock', but did not specify a quantity, then the unit will automatically be zero.

Low stock
In this field, enter the quantity at which you would like to be notified about the low stock. Notification of low stock of an item or its complete absence will be sent to the owner’s email at 10:00 A.M. in the time zone that you have specified. If there are no items with low stock, no notification will be sent to you.

Modifier  - "Name of modifier"
Here, it's only necessary to specify one character: 'Y' (Yes) – if the item has a modifier, or 'N' (No) – if it is not available.

Tax  - "Name of tax"
Here, it's only necessary to specify one character: 'Y' (Yes) – if the tax is applied to this item or 'N' (No) – if it is not applied.


See also:

How to Add Items in the Loyverse Back Office

How to Create and Manage Multiple Stores under One Account

How to Use Variants of Items

How to Create a Composite Item

How to Open CSV File in Google Sheets