CSV upload allows you to bulk-create orders inside Riverr.

This is ideal for:

• Migrating orders from another system

• Importing wholesale or offline sales

• Uploading marketplace exports

• Processing large batch orders

Uploaded orders go directly into your production workflow.

---

Step 1: Upload Your CSV

Go to My Orders → Click Upload CSV

You will see:

• Upload CSV File section

• Field Mapping section

Click Browse and attach your CSV file.

Optional:

• Check Skip First Line if your file contains headers.

---

Step 2: Identify the Product (Required)

Each row must include one of the following:

Option A — SKU (Recommended)

Provide the SKU of an existing Riverr product.

OR

Option B — Product ID

Provide the supplier variation ID or GTIN of a valid blank product in the catalog.

You do not need both — but one is required.

---

OPTION A: Using SKU (Recommended)

If you provide a valid Riverr SKU:

• The product already exists

• Artwork is already mapped

• Placements are already defined

• Decoration type is already set

• Mockups already exist (if previously uploaded)

You do NOT need to provide:

• Images

• Placements

• Decoration Type

• Decoration Mapping

• Mockup Images

The order simply attaches to the existing product.

This is the safest and fastest method.

---

OPTION B: Using Product ID (Blank Variation ID / GTIN)

If you provide a supplier Product ID:

You are referencing a blank product that does not yet exist in your Riverr catalog.

In this case, Riverr will:

• Create the product in the background

• Apply your artwork

• Attach placements and decoration settings

• Create the order simultaneously

Important:

Riverr does not generate mockups automatically in this flow.

If you want mockups attached, you must upload them in your CSV.

---

Required Fields When Using Product ID

Because the product is being created dynamically, you must provide:

• Images (print files)

• Placements

• Decoration Type

• Decoration Type Mapping

If these are missing, validation will fail.

---

Field Mapping

After uploading your file, map your CSV columns to Riverr fields.

You must map all required fields marked with *.

---

Core Required Fields

• SKU OR Product ID

• Order ID*

• First Name*

• Last Name*

• Address 1*

• City*

• State*

• Postal Code*

• Quantity*

These are required to create a valid order.

---

Artwork & Placement Fields (Product ID Only)

If using Product ID, you must also map:

Images

These are your actual print files.

You can:

• Add multiple images

• Assign each image to a placement (Front, Back, Sleeve, etc.)

---

Placements

Defines where each image is printed.

Examples:

• Front

• Back

• Left Chest

• Sleeve

---

Decoration Type

Defines production method (DTF, Screen Print, Embroidery, etc.)

---

Mockup Image (Optional)

If you want visual product mockups attached:

• Map a column to Mockup Image

• The first image will be used as the primary product image

If no mockup image is provided:

• The product will be created without visual mockups

• The order will still be valid

• Production will still proceed

---

Step 3: Validate and Save

Click Validate and Save

The system will:

• Verify required fields

• Validate SKU or Product ID

• Check artwork requirements (if Product ID used)

• Validate shipping address

If errors exist, they must be resolved before import continues.

---

What Happens After Upload

Orders created via CSV:

• Do NOT go to Unsynced

• Go directly to Pre-production

• Are immediately eligible for batching The only caveat to this is draft orders. These will be sent to the draft folder for you to then upload the print files for those specific orders and then they will proceed to the "Pre-production" phase.

---

Common Errors

Invalid SKU

The SKU does not match an existing Riverr product.

Solution:

Copy SKU directly from the Product Details page.

---

Invalid Product ID

The variation ID or GTIN is not a valid blank product in the catalog.

Solution:

Verify supplier variation ID.

---

Missing Artwork Fields

You used Product ID but did not provide required Images, Placements, or Decoration Type.

Solution:

Map required artwork fields.

---

Incomplete Address

Required shipping fields are missing.

Solution:

Ensure all required address columns are mapped.

---

Best Practice

For bulk imports:

Use SKU whenever possible.

Only use Product ID when intentionally creating new products during import.