CSV Import
Our CSV import tool enables you to easily bulk import tracking information to orders from CSV files. To utilize this tool, simply follow these steps:
Fulfillment > CSV import
Preparing the CSV file
The CSV file requires 5 mandatory columns, with column header names that must be followed exactly. In addition, there are 2 optional columns that may also be included. It is essential to ensure that all the mandatory columns are present in the file.
ATTRIBUTE | TYPE | VALUE | DESCRIPTION |
---|---|---|---|
order_id | string | WooCommerce Order ID (i.e 12345) | compatible with a few Custom Order Numbers plugins |
tracking_number | string | Tracking number | |
tracking_provider | string | Shipping Provider Name | the name must match the provider name on the shipping providers list. |
date_shipped | date | DD-MM-YYYY or MM-DD-YYYY | Date when the package was shipped. Optional – keep Blank to use the import date. |
status_shipped | int | Do Not Change – 0 (null) Completed (Shipped)/Shipped – 1 Partially Shipped – 2 | Update the order status and send the shipping confirmation email |
sku* | string | Line item (product) SKU | The product or variation SKU – The SKU must exactly match and be unique per product/variation |
qty* | int | Line item (product) quantity | The quantity of the product SKU that was shipped |
*The Tracking Per Item feature is available in the AST Pro
Please avoid 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 on 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
- Upload the CSV file from your computer
- 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
- Choose the Date Format in the CSV file, you can choose between 2 formats – dd-mm-YYYY or mm-dd-YYYY
- 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 an order #12345 with 4 items:
- T-shirt (TSHIRT) x 2
- Blue-jeans (BJEANS) x 2
Lets 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:

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

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