Skip to main content
How to import orders via a CSV file?

Learn how to efficiently import orders in bulk using a CSV file and streamline order management

Updated over 4 months ago

This article provides a comprehensive guide on importing orders efficiently using a CSV file. Streamline your order management by importing orders in bulk, eliminating the need for manual entry.


Preparing Your CSV File for Import

Before initiating the import process, ensure your CSV file is correctly structured. Download the CSV template to guarantee accurate data formatting. Each row in the CSV file should represent a single line item, allowing orders to span multiple rows. Utilize the "orderReferenceId" column to link line items to their corresponding orders.

For each row, include essential order details:

  • Order Reference ID

  • Shipping Details

  • Item Details

  • URLs for Each Print Area

For a detailed explanation of the required fields in the CSV file, refer to the "Create order" page in our API documentation. This comprehensive resource provides valuable insights into structuring your import data effectively: Create order.


Importing Orders: A Step-by-Step Guide

Follow these steps to import your orders seamlessly:

  1. Access your orders page and click the "Import" button.

  2. Choose the designated store for your imported orders. These orders will be marked as placed from the selected store. You have the flexibility to import them as manual orders as well.

  3. Upload the CSV file containing the orders you want to import. You can also download a fresh CSV template from this page.

  4. Double-check that you've selected the correct destination store and import file. Once everything is in order, click "Import" to begin the import process.

    You'll receive a notification confirming the initiation of the import process.

  5. Once the import process is finished, we'll send you an email notification. This email will provide a summary of the import, including:

    • The total number of orders in the import file.

    • The number of orders successfully imported.

    • The number of orders that failed to import.

Additionally, the email will include a CSV file containing detailed import results. This file will have three columns:

  • orderReferenceId

  • result (indicating "success" or "failure" for each order)

  • errors (providing specific reasons for any import failures)

Did this answer your question?