Skip to main content

CSV Import and Export

Use CSV files to import and export data to your Finqu account, such as products or customer information.

Updated over a week ago

What is a CSV?

A CSV is a text file that stores data in tabular format. CSV files can be edited using a text editor or spreadsheet tools like Google Sheets or MS Excel.

CSV transfers can be useful in cases like:

  • You’re moving your online store to Finqu.

  • You’re leaving Finqu and want to download product, customer, or order data to your computer.

  • You want to create a custom report on your own computer with data not available in Finqu’s built-in reports.

Preparing the files

To import data using CSV, the files need to be in a format compatible with Finqu. The easiest way to get started is by exporting data from Finqu first. If you haven’t added any products yet, start by adding at least one product and category manually in your admin, then follow the export instructions in the Exporting data section.

If you're updating data using a CSV, simply modify the exported files and import them back.

If you're importing new data, edit your own CSV files to match the structure of Finqu’s CSV files. Pay special attention to the header row (row 1), which must contain the exact same column titles.

Importing data

To import data into your Finqu account:

  1. Go to Top right menu > Data transfer.

  2. Click Start new import.

  3. Click Add file.

  4. Select the file(s) from your device.

  5. Click Start import.

Before importing, scroll down this guide to review tips on editing files.

Notice: Importing product variations via CSV is not currently supported.

Exporting data

You can export data from the areas shown in the table below. Once exported, download the file(s) from Top right menu > Data transfer in your admin.

Data

Where to export in admin

Products

Products > Actions > Export data

Categories

Products > Categories > Actions > Export data

Inventory

Products > Inventory > Export

Orders

Sales > Export

Customers

Customers > Export

Tips

ID numbers

CSV files include various ID numbers such as product_id, manufacturer_id, tax_id, etc. An ID uniquely identifies a data item. For example, every product has a unique product_id.

ID numbers when updating data

If you're updating data, first export the data from the system. Make changes to the exported file and then re-import it. Do not change the ID numbers — they are used to match updates to the correct records.

ID numbers when importing new data

When adding new products, you can use any unique value in the ID field. A simple option is to use sequential numbers like 1, 2, 3, etc.

Empty fields

When updating via CSV, keep in mind that empty fields will clear existing values in the system. For example, if the name column is empty for a product, the name will be removed (see image below). If you don’t want a value to change, remove the column entirely from the CSV.

Example 1: The three highlighted rows will save an empty name if this CSV is imported.

Example 2: To keep existing data unchanged, remove the column completely from the CSV.

CSV delimiter and decimal separators

CSV columns are separated by commas.

Decimals in numbers (e.g., prices or weights) use a period.

These delimiters may not be visible in spreadsheet programs like Excel or Google Sheets. Errors can occur if a different delimiter (such as a semicolon ;) is used.

Check your software settings or open the file in a simple text editor like Notepad (Windows) or TextEdit (macOS).

Example: Columns are separated by commas, and decimals use periods:

product_id,name,net_price,weight,weight_unit
123,ExampleProduct1,8.06,0.5,kg
456,ExampleProduct2,16.13,0.6,kg

Column headers

Correct column headers are crucial for a successful import. You can export sample files from your Finqu account, and use them as a guide for your imports.

Importing images

You can import product images by adding the image URL to the CSV. The importer will download the image from the URL and store a copy on Finqu’s server. You cannot import images using ZIP files.

Start with small files

If you’ve never imported CSV data into Finqu, try using a small file first. Create a test CSV with just one product. After importing, verify that the data was correctly saved in the system. Once you're confident that the file format is correct, you can proceed with importing larger datasets.

Did this answer your question?