> 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/riverr-integration.md).

# Riverr Integration

> New to Order Desk? Order Desk collects all your orders from all your sales channels in one place and sends them to your chosen fulfillment services automatically.
>
> <i class="fa-computer" style="color:$primary;">:computer:</i> [See all integrations](https://www.orderdesk.com/integrations/) . <i class="fa-wallet" style="color:$primary;">:wallet:</i> [Pricing](https://www.orderdesk.com/pricing/) . <i class="fa-arrow-right" style="color:$primary;">:arrow-right:</i> [Start free trial](https://app.orderdesk.me/account-setup)

Order Desk can submit your print on demand orders to [Riverr](https://riverr.app/). As orders are fulfilled, shipment details will automatically be pulled back into Order Desk and sent to the original shopping cart.

### Setup

To connect to Riverr, click on **Manage Integrations** in the left sidebar. Under the **Print on Demand** tab, find and click to enable the Riverr integration.

<figure><img src="https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2Fs4DkqtFAarTZ3qubsOfR%2FCleanShot%202026-10-26%20at%2014.54.02%402x.png?alt=media&amp;token=dd916dfd-723f-4b5f-abd9-be44b36c4d00" alt=""><figcaption></figcaption></figure>

Alternatively, search for Riverr from the available integrations search.

<figure><img src="https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FO5rRX8brUVEvzmrsy1Bs%2FCleanShot%202026-10-26%20at%2014.53.34%402x.png?alt=media&amp;token=0aa486bb-394f-4a3f-980f-cfd187a0f3b1" alt=""><figcaption></figcaption></figure>

Enter your Riverr credentials, then click **Connect**.

<figure><img src="https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FoN3AY0wVBaAo4SlN61uT%2FCleanShot%202026-10-26%20at%2014.55.43%402x.png?alt=media&amp;token=8d37c2f3-f78f-4749-8bcf-8add49a6b88e" alt=""><figcaption></figcaption></figure>

{% hint style="info" icon="hand-back-point-right" %}
Please note that Order Desk isn't able to help find or reset your credentials, as they can only be provided by the Riverr team.
{% endhint %}

### Integration settings

Once connected, you will have a few settings where you can set your preferences for this integration.

<div align="left"><figure><img src="https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FjvZNvEklnmBzAsIKMmu2%2FCleanShot%202026-10-26%20at%2014.59.56%402x.png?alt=media&amp;token=bb73b8c1-108f-4336-b7ab-a5c01dda9238" alt="" width="563"><figcaption></figcaption></figure></div>

#### Default Shop

Select the Riverr shop you want your orders to be created under.

This shop will be used for all orders unless a different shop is specified using the `ShopID` field on the order. More about that [here](#preparing-your-orders).

#### After Import, Move To

Select the folder you want orders to be moved into after they are sent to Riverr.

If you want to use a custom folder, create your own from Store Settings. See the [Working with Folders](https://help.orderdesk.com/) guide for more information.

#### After Shipment, Move To

Select the folder you want orders to be moved into when Riverr sends shipment details back into Order Desk.

#### If Canceled, Move To

Select the folder you want orders to be moved into when Riverr sends shipment details back into Order Desk.

### Product Settings

For detailed information on what the product settings within the Riverr integration do, please read the [**Print on Demand Product Settings**](https://help.orderdesk.com/guided-walkthroughs/print-on-demand-walkthrough/print-on-demand-integration-product-settings.md) guide.

<figure><img src="https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FnkQI4Ecnesp5wkmM3mc6%2FCleanShot%202026-10-26%20at%2015.00.06%402x.png?alt=media&amp;token=1219ac5c-8583-4f21-b24e-6b73e0f36784" alt=""><figcaption></figcaption></figure>

### Sending Orders to Riverr

Getting your orders ready to send to Riverr will take some setup 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**](https://help.orderdesk.com/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. If you are unfamiliar with checkout data, see the [How to Work with Checkout Data](https://help.orderdesk.com/guided-walkthroughs/orders-and-folders/how-to-work-with-checkout-data) guide.

| Field Name    | Description                                                                                                                                                       |
| ------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| ShopID        | The Riverr shop the order should be created under. If this field is not set, the [Default Shop](#default-shop) selected in the integration settings will be used. |
| carrier\_code | The carrier code to send to Riverr as part of the order's shipping options.                                                                                       |
| service\_code | The carrier service code to send to Riverr as part of the order's shipping options.                                                                               |
| package\_code | The package code to send to Riverr as part of the order's shipping options.                                                                                       |

#### Preparing Your Items

The following fields can be set as variations or item metadata for each order item. These fields tell Riverr which product to fulfill and, when necessary, which artwork to print.

Riverr supports two types of items:

* **Catalog Products:** Products that have already been set up in Riverr.
* **Blank Products:** Products that are sent to Riverr using a GTIN and print files.

{% hint style="warning" %}
An order can contain only one item type. You cannot mix catalog products and blank products within the same order.
{% endhint %}

Choose the option below that best matches how your products are set up in Riverr.

#### Catalog Products

If you've already set up your products in Riverr, you can send their product and variant IDs to identify the exact products you want Riverr to fulfill.

Both `ProductID` and `VariantID` must be provided for each catalog item.

| Field Name | Description                                                                   |
| ---------- | ----------------------------------------------------------------------------- |
| ProductID  | The Riverr product ID for an item that already exists in your Riverr catalog. |
| VariantID  | The Riverr variant ID of the exact product variation you want to fulfill.     |

{% hint style="warning" %}
Both fields are required for catalog products. If an item does not have both a `ProductID` and a `VariantID`, Riverr will treat it as a blank-product item, which requires a GTIN and at least one print file.
{% endhint %}

#### Blank Products

Use this option when you want to send Riverr a blank product along with the artwork that should be printed on it.

Instead of referencing an existing catalog product, you will provide the GTIN of the blank product variation and the print files Riverr should use.

| Field Name           | Description                                                          |
| -------------------- | -------------------------------------------------------------------- |
| gtin *or* print\_sku | The GTIN of the Riverr blank product variation you want to print on. |

Each blank-product item must have a valid GTIN and at least one print file.

#### Print File Fields for Blank Products

When sending blank products, you will also need to provide the artwork file links. You can optionally include print locations, preview images, and a decoration method. The following fields can be set as variations or item metadata.

| Field Name         | Description                                                                                                                                                                                                                                                        |
| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| print\_url\_x      | Set a publicly accessible link to the artwork you want Riverr to print. You can pass multiple artworks using `print_url_1` through `print_url_5`. At least one print file is required for blank products.                                                          |
| print\_location\_x | <p>Set the print location for the corresponding artwork. Supports <code>print\_location\_1</code> through <code>print\_location\_5</code>.<br>You can provide a Riverr placement ID or a placement name, such as <code>Back</code> or <code>Left Chest</code>.</p> |
| print\_preview\_x  | Set the URL of a mockup image for the corresponding print file. Supports `print_preview_1` through `print_preview_5`.                                                                                                                                              |
| decoration\_method | Set the Riverr decoration method ID for the item.                                                                                                                                                                                                                  |


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
