Docly Child

CSV Import

The CSV import tool enables you to bulk import tracking information to orders from CSV files.

Preparing the CSV file

The CSV file consists of five mandatory columns, with column header names that must be followed exactly. In addition, there are two optional columns that may also be included. It is essential to ensure that all the mandatory columns are present in the file:

order_idstringWooCommerce Order ID (i.e 12345)compatible with a few Custom Order Numbers plugins
tracking_providerstringShipping Provider Namethe name must match the provider name on the shipping providers list.
tracking_numberstringTracking number
date_shippeddateDD-MM-YYYY or MM-DD-YYYYDate when the package was shipped. Optional – keep Blank to use the import date.
status_shippedintDo Not Change – 0 (null) Completed (Shipped)/Shipped – 1 Partially Shipped – 2Update the order status and send the shipping confirmation email
sku*stringLine item (product) SKUThe product or variation SKU – The SKU must exactly match and be unique per product/variation
qty*intLine item (product) quantityThe quantity of the product SKU that was shipped

*Please note: The Tracking Per Item feature is only available in the AST Pro version.

Please avoid using Excel when you create or edit the CSV files since it adds formatting and character encoding to the CSV files and that can cause issues with the import. We recommend using the following CSV editors:

  • Google spreadsheets (Google Drive)
  • Free spreadsheet app in OpenOffice

Example of CSV file:


You can download a sample CSV file:

Import the CSV file

  1. Upload the CSV file from your computer
  2. Choose if you would like to override the existing tracking details for the orders or to add the tracking in addition to existing tracking numbers
  3. Choose the Date Format in the CSV file, you can choose between 2 formats – dd-mm-YYYY or mm-dd-YYYY
  4. Click continue to start the import process, once the import completes you will get a detailed report of any issues in the import.

Upload the CSV file, choose import settings, and click continue to start the import:


The import will begin and will display the status of the imported tracking numbers:


Once the import completes you will get a detailed report of any issues in the import:


Import Tracking per item from CSV

The AST PRO allows you to Import tracking numbers per item and adds 2 columns in the CSV file, the product SKU and the quantity shipped.

For example, if we received order #12345 with 4 items:

  1. T-shirt (TSHIRT) x 2
  2. Blue jeans (BJEANS) x 2

Let’s assume that you ship these products in 2 boxes, each has its own tracking number, one tracking number for the T-Shirts and one for the Blue Jeans:


When you ship the T-Shirts and the Blue Jeans as a set, each set in a package with different tracking number, the CSV File should be formatted this way:


You can download a sample CSV file for an example of the correct formatting:


Billed annually

Buy Now