Firstly, please download the CSV template. Once you have downloaded the CSV file, use the chart below for a description of the columns.
Note:
The term "string" used below refers to a set of characters that can also contain spaces and numbers.
Be sure to review your products and orders in the Fuel app to ensure that they line up with your expectations. If they do not:
Column | Required | Description |
Order Name | Yes. |
|
Shipping Address 1 | Yes. | String. |
Shipping Address 2 | No. |
|
Shipping City | Yes. | String. |
Shipping State | Yes. | String. |
Shipping Country Code | Yes. |
|
Shipping Zip | Yes. |
|
Shipping Phone | No. |
|
Customer First Name | Yes. | String. |
Customer Last Name | Yes. | String. |
Customer Email | No. | String. |
Item Quantity | Yes. |
|
Product ID | Yes. |
|
Color |
|
|
Size |
|
|
Product Title | Yes. |
|
Front Artwork | Yes. |
|
Front Artwork Position | No. |
|
Front Artwork Size |
|
|
Front Artwork Vertical Offset | No. |
|
Front Artwork Horizontal Offset | No. |
|
Back Artwork | No. |
|
Back Artwork Position | No. |
|
Back Artwork Size |
|
|
Back Artwork Vertical Offset | No. |
|
Back Artwork Horizontal Offset | No. |
|
Use QuickShip | No. |
|
Example shirt order #1
Column | Required |
Order Name | #TUTO_001 |
Shipping Address 1 | 123 Main Street |
Shipping Address 2 | Suite #2 |
Shipping City | San Francisco |
Shipping State | CA |
Shipping Country Code | US |
Shipping Zip | 94110 |
Shipping Phone |
|
Customer First Name | Tom |
Customer Last Name | Smith |
Customer Email | |
Item Quantity | 1 |
Product ID | gildan-cotton-tank-top |
Color | White |
Size | M |
Product Title | TUTO_001 - Donut Madness Tank |
Front Artwork | Donut Madness.png |
Front Artwork Position | LC |
Front Artwork Size | 2.5 |
Front Artwork Vertical Offset | 2 |
Front Artwork Horizontal Offset |
|
Back Artwork |
|
Back Artwork Position |
|
Back Artwork Size |
|
Back Artwork Vertical Offset |
|
Back Artwork Horizontal Offset |
|
The order will create the following product:
“A medium White Gildan Cotton Tank Top T-shirt with the Donut Madness artwork on the left-hand side of the product, with 2.5 in of width and 2 in from the neck”.
Example shirt order #2
Note: Moving forward, the examples will not include the customer information since it will be the same across all orders.
Column | Required |
Order Name | #TUTO_002 |
Item Quantity | 2 |
Product ID | gildan-ultra-cotton-t-shirt |
Color | Carolina Blue |
Size | S |
Product Title | TUTO_002 - Gildan Ultra Cotton |
Front Artwork | Donut Madness.png |
Front Artwork Position | C |
Front Artwork Size | 5 |
Front Artwork Vertical Offset | 3 |
Front Artwork Horizontal Offset |
|
The data above will produce the following item.
“A small Carolina Blue Gildan Ultra Cotton T-shirt with the Donut Madness artwork in the center of the product, with 5 in of width and 3 in from the neck”.
Example hat order
Column | Required |
Order Name | #TUTO_003 |
Item Quantity | 2 |
Product ID | yupoong-adult-retro-trucker-cap |
Color | Royal/White |
Size | M |
Product Title | TUTO_003 - Youpong Adult Retro Cap |
Front Artwork | Donut Madness.png |
Front Artwork Position | C |
Front Artwork Size | 2 |
Front Artwork Vertical Offset | 0 |
Front Artwork Horizontal Offset |
|
The data above will produce the following product.
“A medium Royal/White Yupoong Retro Trucker Cap with the Donut Madness artwork in the center of the product, with 2 in of width and 0 in from the top of the printable area”.
Example poster order #1
Column | Required |
Order Name | #TUTO_005 |
Item Quantity | 3 |
Product ID | gloss-poster |
Color | White |
Size | 16x24 |
Product Title | TUTO_005 - Gloss Poster |
Front Artwork | red_1200x1200.png |
Front Artwork Position | C |
Front Artwork Size | 50 |
Front Artwork Vertical Offset | 50 |
Front Artwork Horizontal Offset | 50 |
The data above will produce the following product.
“A 16x24 White Gloss Poster with the red_1200x1200 artwork in the center of the product, with 8 in of width (50%) (height is scaled proportionally based on the aspect ratio of the artwork), 0 in from the top of the printable area”.
The order sets the horizontal and vertical offsets to 50%; the artwork is placed at the center of the poster. Remember, the horizontal and vertical offsets are relative to the center of the artwork.
And for width, as it was also set to 50%, it takes half of the printable area.
The height is scaled proportionally based on the width, and as it is a square, the height is the same as the width.
Example poster order #2
Column | Required |
Order Name | #TUTO_003 |
Item Quantity | 3 |
Product ID | gloss-poster |
Color | White |
Size | 16x24 |
Product Title | TUTO_005_02 - Gloss Poster |
Front Artwork | red_1200x1200.png |
Front Artwork Position | C |
Front Artwork Size | 50 |
Front Artwork Vertical Offset | 0 |
Front Artwork Horizontal Offset | 0 |
The data above will produce the following product.
So, to place the image exactly in the top left section of the poster, we can set the offsets to 25%.
Example poster order #3
Column | Required |
Order Name | #TUTO_005_2 |
Item Quantity | 3 |
Product ID | gloss-poster |
Color | White |
Size | 16x24 |
Product Title | TUTO-005_2 - Gloss Poster |
Front Artwork | red_1200x1200.png |
Front Artwork Position | C |
Front Artwork Size | 50 |
Front Artwork Vertical Offset | 25 |
Front Artwork Horizontal Offset | 25 |
The data above will produce the following product.
Bags
It behaves the same as apparel.
Phone Cases
It behaves the same as posters.
Mugs
Latest change on Mug artwork sizing when a 100% image size is requested:
Old version: 100% of width refers to both sides of the mug.
New version: 100% of width refers to only 1 side of the mug.
Image Autofit
Garment and Totes
Based on your image aspect ratio, there will be three scenarios:
Your image aspect ratio is equal to the product print area aspect ratio: The image will be sized so it perfectly fits the product design area.
Your image aspect ratio is greater than the product print area ratio: The image will be sized so its height is equal to the product print area height.
Your image aspect ratio is smaller than the product print area ratio: The image will be sized so its width is equal to the product print area width.
Other Product Categories
The image will be optimized for maximum coverage of the print area.
Bigger aspect ratio image:
Lower aspect ratio image: