Dispatch articles

Bulk Shipment Import CSV Formatting

Last updated: 11 Oct 2025

Share this article

Instructions for preparing bulk Shipment CSV import

Please use the following guide to prepare your shipment import file. All fields must be included in the header row of your CSV. Required fields must contain a value for each row; optional fields can be left blank.

General format

File must be a CSV (Comma-Separated Values) file.
The first row must include all headers as shown below.
All values are treated as strings, unless specified otherwise (e.g. numbers or yes/no fields).
Field names must match exactly – do not rename columns.
Product-related fields (e.g. product_1_sku, product_2_quantity, etc.) should be repeated for each product in the row, using ascending numbers.
Leave product-related fields blank for shipments that contain fewer products. For example, if a shipment includes only two products, any columns for product_3_sku, product_3_quantity, etc., should be left empty.

Download reference CSV template file

To get started, click here to download the reference CSV file to use for preparing your own data.

Destination fields

Field	Notes
recipient_email	Required. This is the email address we will send tracking notifications to.
`destination_first_name`	Recipient's first name. Required.
`destination_last_name`	Recipient's last name. Required.
`destination_line_1`	Street address line 1. Required.
`destination_line_2`	Street address line 2. Optional.
`destination_line_3`	Street address line 3. Optional.
`destination_city`	City or suburb. Required.
`destination_state`	Alphanumeric state identifier. Optional.
`destination_postal_code`	Optional.
`destination_country`	2- or 3-letter country code (e.g. `AU`, `US`). Required.
`destination_phone`	Optional.
`destination_company`	Optional. Use if shipping to a business.
`destination_location_type`	Required. Must be `residential` or `commercial`. Note: This is case sensitive.

Tax and handling fields

Field	Notes
`taxes_collected`	`yes` or `no`. Defaults to `no` if blank.
`tax_handling`	Required if destination country collects taxes. One of: `ltt`, `ddp`, `recipient`, `recipient_business`.
`recipient_tax_id`	Required if `tax_handling` is `recipient_business`.
`recipient_registered_business_address`	Required if `tax_handling` is `recipient_business`.

Additional shipment information

Field	Notes
`customer_reference_number`	Optional. Must be unique if specified.
`special_requests`	Optional. Notes for warehouse staff.

Product details

Each shipment can contain multiple products. To add multiple items, repeat the field group with increasing numbers (e.g. product_1_sku, product_2_sku, etc.).

Field	Notes
`product_*_sku`	Required. Must match a valid SKU from your Dispatch Inventory. It can be either the Dispatch SKU (e.g. DIS-PRO-20250619-1) or your own product SKU listed.
`product_*_quantity`	Required. Must be a whole number greater than 0.
`product_*_declared_value`	Optional. Defaults to cost of goods if left blank. Must be equal to or greater than cost of goods.

⚠️ Important: Each product within a shipment row must be unique. Do not repeat the same SKU with different declared values.

Final tips

Rows with missing required fields or invalid data will be skipped and reported as errors.
Ensure all SKUs and country/state codes are correct and up to date.

How do I calculate the cost of my project?

At the top of your component list page is a Unit Price Estimator button. Click on this to view a custom board game pricing estimate for your project as it currently stands.

Adjusting the number of units to be produced will show the effect of different quantities on the cost per unit. The more units you make, the lower the cost per unit and overall board game manufacturing cost.

Beneath the number of unit selectors, there are two tabs:

Project breakdown: This is a list showing the individual components in your project and the cost associated with each element, helping you understand your custom board game price in detail.

Unit cost price breaks: This is a visual way to show where the major price breaks occur and how this affects the cost per unit.

How do I create an order?

Create an order: At the bottom of your component page, click the ‘Create Order’ button.

Name the order: Give your order a name.

Select projects: Select which projects you wish to add to your order.

Set quantity: Set your quantity of units for each project in your order. A total price indicator will specify the total cost.

Select shipping address: Select the address you’d like this order shipped to. You are also able to add and select a different address.

Review order: Choose a delivery option for your project from the list provided, then click ‘Complete your order’. You will be required to make payment before your order is sent off to review & production.

Important Notes

Only projects including a container/box can be selected.

Only projects with artwork that has passed preflight can be selected.

How do I pay for my order?

If you wish to proceed with a specific order, you’ll need to follow the Order process, which includes:

Confirm quantity & price.

Confirm shipping address.

Review your order.

Once this is done and if you’re happy to proceed, choose a courier service you’d like to go with.

Click on ‘Complete your order’ and you will be taken off to a secure page to make payment.

Once payment has been finalised, your order will now be active and will be reviewed by a Launch Tabletop representative shortly.

How do I choose between the types of boards?

The two most important things to consider are:

The size of the board you need when it's unfolded and ready for play and

The box size you need to fit it into when folded to be put away.

Taking those two things into account, decide on whether you prefer a bi-fold or a quad-fold board, whether you want to print on 1-side or both sides of the board, choose a finish on the printed sides, and select from the sizes available. For more compact board games, you may prefer a bi-fold, whereas long epic adventures may require a large quad-fold board to create an immersive tabletop experience. These formats are ideal for custom-made board games that demand a unique play style or footprint. Read more about our game board options.

Have any questions that aren’t covered above? You may find the answer over in our Knowledge Base.

Join Launch Lab now for free

Home

Launch Lab

Dispatch

TCG Smith

Roles

Resources

About

Shop