> For the complete documentation index, see [llms.txt](https://help.orderdesk.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.orderdesk.com/integration-setup-guides/print-on-demand/printful-integration.md).

# Printful Integration

Order Desk can submit your print on demand orders to [Printful](https://www.printful.com/). When Printful fulfills your orders, the shipment info will automatically be pulled back into Order Desk and sent back to the original shopping cart, if your store is set up to do so.

### Setup

To connect to your Printful account, click on **Manage Integrations** in the left sidebar. Under the **Print on Demand** tab, look for and enable the Printful integration.

![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FCKPqvE1LB2Q90d0mTuu5%2Flegacy-579d0c5ca0dd931a395b.png?alt=media)

Once enabled, click **Connect To Printful**.

![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FJxpg27mFk4MUAA0w3a9O%2Flegacy-7066f78af251ad223a84.png?alt=media)

You will be redirected to Printful to confirm you’d like to give Order Desk access. **In order to authorize your connection, you must be logged into your Printful account as an Admin/Owner.**

![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FmM2vKtZLgbFqhx9OBnFB%2Flegacy-fd60e5803e941951655c.png?alt=media)

### Settings

![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2F0DGvV63LKsxNkkflKBo0%2Flegacy-534b428df7fe5c4086ab.png?alt=media)

Once connected, you can set your preferences for this integration in the Basic Settings.

#### Default Shipping Class

Select the default shipping class you want Printful to use. The shipping method you select will be used for all orders where the method on the order does not match any of Printful’s shipping method names.

If you need to apply specific methods for certain orders, match your method names to Printful’s names in the [Shipping Class Match section](#shipping-class-match) below.

#### After Import, Move To

Choose the folder where orders should be moved to after they are successfully sent to Printful.

You can choose the default Prepared folder for this, or create your own folders in your Store Settings. Read the [Working with Folders](/start-here/getting-started-series/quick-start-overview.md#working-with-folders) guide for more information.

#### After Shipment, Move To

Choose the folder where orders should be moved to as Printful sends tracking details back.

#### If Canceled, Move To

Choose the folder where orders should be moved to if they are canceled at Printful.

#### Automatically Confirm Submissions

Select this to automatically submit the newly created order for fulfillment in Printful. This will skip the draft phase.

If not selected, you will need to go into Printful to manually confirm your orders after submitting them from Order Desk.

#### Send Customer Email Address to Printful

If you would like the customer’s email address to be sent with the order details, select this option.

#### Product Settings

![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2Fg2x8hztJoS6cnuz5r6W9%2Flegacy-8b5be5e4e451ab2238ea.png?alt=media)

For more information on what the product settings within the Printful integration do, please read the [Print on Demand Product Settings](/guided-walkthroughs/print-on-demand-walkthrough/print-on-demand-integration-product-settings.md) guide.

#### Shipping Class Match

![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FfJulSFT6Bo1LsvQ8zBqE%2Flegacy-01f83ff91a6cc8f4da6b.png?alt=media)

If the shipping methods you set up in your shopping cart(s) don’t match the shipping method names Printful uses, they won’t know what methods you intend for them to use. When this happens, the [default mail classes applied above](#settings) will be used instead for all of your orders.

To tell Printful what methods you want them to use, you will need to match your method names to theirs. This can be done in the shipping class match section. For detailed instructions on setting this up, please read through the [shipping class match](/guided-walkthroughs/shipping-fulfillment-and-returns/how-to-set-up-shipping-class-matches.md) guide.

### Sending Orders to Printful

Getting your orders ready to send to Printful will take some set up time. For a detailed walkthrough of how to use Order Desk with your Print on Demand orders, please read through our [Print on Demand Fulfillment](/guided-walkthroughs/print-on-demand-walkthrough/print-on-demand-fulfillment.md) guide.

#### Preparing your Orders

The following fields can be set as checkout data or order metadata on each order.

| Field Name         | Field Description                                                                                                  |
| ------------------ | ------------------------------------------------------------------------------------------------------------------ |
| TaxNumber          | **Required** if the order destination is Brazil, optional for all other countries. Adds a tax number to the order. |
| GiftMessageTitle   | Only used if you have set a gift message field on the settings page and the customer created a gift message.       |
| PackingSlipEmail   | Override the default email field for the packing slip.                                                             |
| PackingSlipPhone   | Override the default phone field for the packing slip.                                                             |
| PackingSlipMessage | Override the default message field for the packing slip.                                                           |

If you are unfamiliar with checkout data, see the [How to Work with Checkout Data](/guided-walkthroughs/orders-and-folders/how-to-work-with-checkout-data.md) guide.

#### Preparing Your Items

The following fields can be set as variations or item metadata for each order item.

| Field Name                      | Field Description                                                                                                                                                  |
| ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| print\_url                      | **Required.** Link to your artwork file. For multi-print items, use print\_url\_1, print\_url\_2, etc., up to 7.                                                   |
| print\_sku                      | Printful’s Variant ID. See [below](#how-to-determine-the-printsku) for instructions.                                                                               |
| sync\_variant\_id               | If you have an existing product stored in Printful, it can be identified using the data in this field.                                                             |
| external\_variant\_id           | If you have an existing product stored in Printful, it can be identified using the data in this field.                                                             |
| warehouse\_product\_variant\_id | If you have an existing product stored in Printful, it can be identified using the data in this field.                                                             |
| print\_location                 | Location of the artwork on the item. For multi-print items, use print\_location\_1, print\_location\_2, etc., up to 7. If not set, “default” will be used.         |
| print\_preview                  | The location of the printable file preview. For multi-print items, use print\_preview\_1, print\_preview\_2, etc., up to 7.                                        |
| stitch\_color                   | Embroidery stitch color.                                                                                                                                           |
| product\_id                     | Printful’s ID for the product. This can be used instead of the print\_sku as long as the color and size variants are applied, if applicable.                       |
| color                           | Color variant of the item.                                                                                                                                         |
| size                            | Size variant of the item.                                                                                                                                          |
| auto\_thread\_color             | Use this field name with a value of **1** to automatically match the available thread colors to the image provided in the print\_url field.                        |
| full\_color                     | Set this to a value of **1** to have Printful use the *unlimited color* option for your thread.                                                                    |
| inside\_pocket                  | Use this field name with a value of **1** to confirm item has an inside pocket. **Required for all over print yoga leggings.**                                     |
| label\_inside                   | Use this field name to pass the type of label on the item. Options are **native** and **inside\_label\_type**. If no value is assigned, the default is native.     |
| custom\_border\_color           | Use this field to set the custom border color you want to send to Printful. It accepts a hexadecimal color value, like `#FFFFFF` for white or `#000000` for black. |
| license\_type                   | If your product design is associated with one or more licensing programs, you can list the license type(s) here, separated by commas.                              |

You can also set custom thread colors on specific locations, using the following values. For more information, you can also refer to Printful’s [guide](https://www.printful.com/blog/t-shirt-design-placement-guide) on design placement.

| thread\_colors\_front                | Front of item.                                          |
| ------------------------------------ | ------------------------------------------------------- |
| thread\_colors\_back                 | Back of item.                                           |
| thread\_colors\_right                | Right side of item.                                     |
| thread\_colors\_left                 | Left side of item.                                      |
| thread\_colors\_apparel              | Thread colors for apparel.                              |
| thread\_colors\_apparel\_back        | Thread colors for back of apparel.                      |
| thread\_colors\_chest\_center        | Target the chest of item.                               |
| thread\_colors\_large\_center        | Target the center of item.                              |
| thread\_colors\_large\_corner\_right | Target the upper right corner of item.                  |
| thread\_colors\_chest\_left          | Target the left side of chest.                          |
| thread\_colors\_corner\_left         | Target the upper left corner of item.                   |
| thread\_colors\_chest\_top\_left     | Target the upper left side of chest.                    |
| thread\_colors\_corner\_right        | Target the upper right corner of item.                  |
| thread\_colors\_outside\_left        | Set custom outside thread on the left.                  |
| thread\_colors\_outside\_right       | Set custom outside thread on the right.                 |
| thread\_colors\_inside\_left         | Set custom inside thread on the left.                   |
| thread\_colors\_inside\_right        | Set custom inside thread on the right.                  |
| thread\_colors\_patch\_front         | Set custom thread color for patch on front of item.     |
| thread\_colors\_sleeve\_left\_top    | Set custom thread color for upper area of left sleeve.  |
| thread\_colors\_sleeve\_right\_top   | Set custom thread color for upper area of right sleeve. |
| thread\_colors\_wrist\_left          | Set custom thread colors for left wrist area.           |
| thread\_colors\_wrist\_right         | Set custom thread colors for right wrist area.          |

#### How to Determine the print\_sku

The print\_sku is the **Variant ID**, which can be found in Printful’s product list. To find this, click the **View Available Products** link at the top of the integration settings:

![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FTb9f67T6RyRsMppMbsYP%2Flegacy-a96268914cd77a7c93e9.png?alt=media)

Find the product you want to order and click the name of it.

![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2F3yUEXdaP7wyfHVKmnS3I%2Flegacy-f74149aeba869260b2f2.png?alt=media)

The Variant ID is listed for each unique variant of that product:

![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2F2lxnoK9E4wWgmFrdzcH8%2Flegacy-cbfea9fa201405466b49.png?alt=media)

Choose the variant you want, for instance if you want to order the black beanie, use 4522, and set that value as the print\_sku on your item:

![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FbioFQ658cME1iVY9GfUj%2Flegacy-42f089d2e3af57790881.png?alt=media)

Alternatively, you can use the Product ID instead, but will need to include the color and size variations, if applicable, so Order Desk can look up the appropriate Variant ID for the product to send to Printful. The Product ID is from the top level product before clicking into the variants:

![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FhT4lkwRbaD6mHqrG6Ylr%2Flegacy-2a8fe5b3f4c417805bfe.png?alt=media)

Using the same example, we know there are multiple colors available for the product ID 81, so to order the black beanie, set the product\_id as 81, the color variation as Black, and the print\_sku isn’t necessary:

![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FPoTAZsJlV4mgsN5atgut%2Flegacy-45f7a3fab998790d31f7.png?alt=media)

This will tell Printful which variant of the product you are ordering. If there are color and/or size variations for the product but these aren’t set on the item in Order Desk when using the product\_id field, the order will error when trying to send to Printful.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.orderdesk.com/integration-setup-guides/print-on-demand/printful-integration.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.