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

# GelatoConnect Integration

Order Desk can add print details and submit your print on demand orders to [**GelatoConnect**](https://www.gelato.com/connect)**.** As orders are fulfilled, 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 for it.

This guide covers how to connect your GelatoConnect account to Order Desk, set up the integration, and send print on demand orders with the correct product and shipping details.

### Setup

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

![](https://s3.amazonaws.com/helpscout.net/docs/assets/57b0032590336059d4edf94f/images/686d2e9b4d9eb57424767b48/file-zfdwh4SmpT.png)

Alternatively, search for GelatoConnect from the available integrations search, then click **Enable**.

![](https://s3.amazonaws.com/helpscout.net/docs/assets/57b0032590336059d4edf94f/images/686d2eaf6aa113248888dc3b/file-ona2JZkEFQ.png)

Enter your GelatoConnect credentials (**API Key**, **Printer ID** and **Connector ID**), then click the **Save Changes** button to connect:

![](https://s3.amazonaws.com/helpscout.net/docs/assets/57b0032590336059d4edf94f/images/686d30e49898bb02b0d1988d/file-AatOiO251u.png)

#### 💡 FINDING YOUR CREDENTIALS

Order Desk isn’t able to help find or reset these credentials, as they can only be provided and managed by GelatoConnect. The best way to locate them is to reach out directly to someone on the GelatoConnect team for support.

### Integration Settings

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

![](https://s3.amazonaws.com/helpscout.net/docs/assets/57b0032590336059d4edf94f/images/686d31a64d9eb57424767b5a/file-uS589msXcd.png)

#### Default Mail Class

Choose the mail class (shipping method) you want GelatoConnect to use for orders by default. If you need to apply specific methods for certain orders, you can match your method names to the ones GelatoConnect uses. See the Shipping Class Match section below for more info.

#### After Import, Move To

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

If you want to use a custom folder, it is possible to create your own from the store settings. See the [**Working with Folders**](/start-here/getting-started-series/quick-start-overview.md#working-with-folders) guide for more information.

#### After Shipment, Move To

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

#### If Canceled, Move To

Select the folder the order should be moved to if canceled at GelatoConnect.

#### Currency

Choose the currency we should use for your order exports.

#### Product Code Match

![](https://s3.amazonaws.com/helpscout.net/docs/assets/57b0032590336059d4edf94f/images/686d337d6aa113248888dc5e/file-D2B5R9aDHJ.png)

For detailed information on what these product settings within the GelatoConnect 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://s3.amazonaws.com/helpscout.net/docs/assets/57b0032590336059d4edf94f/images/686d33692d3e8147c7696adf/file-Rli4Nm5lvL.png)

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

To tell GelatoConnect 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 GelatoConnect

Getting your orders ready to send to GelatoConnect 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.

#### Pre-saved Products

If you’ve already set up your products in GelatoConnect (including designs) ahead of time, you can set an item metadata or variation field called **design\_id**. This should be the variant ID of the exact finished product you want GelatoConnect to print.

| Field Name | Description                                                                                                                                            |
| ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| design\_id | Use this when you already know the exact pre designed product to print in GelatoConnect. Order Desk will find the matching product there and order it. |

#### Custom Products

Use this option when your products are not set up in GelatoConnect ahead of time and you want to send the product details along with the print files.

To send items to GelatoConnect, you’ll need to provide details about the blank product you’re printing on and the artwork files you want them to print.

There are two ways to identify the blank product: you can either use the GelatoConnect product code (also called UID), or use a combination of the product variant name with its attributes.

At least one artwork file is required for all items. You can find a breakdown of how to set all those details below:

| Field Name               | Description                                                                             | When to Use                              |
| ------------------------ | --------------------------------------------------------------------------------------- | ---------------------------------------- |
| print\_sku               | The GelatoConnect product code (or product UID).                                        | Required if using the product UID        |
| ProductVariant           | Name of the product variant to match against GelatoConnect’s catalog.                   | Required if using a product variant name |
| VariantAttributeKey\_x   | The attribute name, such as Size or Color. Replace `x` with a number up to 10.          | Required with **ProductVariant**         |
| VariantAttributeValue\_x | The matching value for each key (e.g., XL, Black). Replace `x` with a number up to 10.  | Required with **ProductVariant**         |
| print\_url\_x            | Link to the artwork file. Replace `x` with a number up to 5.                            | Required At least one for all items.     |
| print\_location\_x       | The location where the artwork should be placed. It must match the `print_url_x` index. | Optional When using **print\_url\_x**.   |

**IN SUMMARY**

If a **print\_sku** is provided, we’ll use it directly to match the product code of the blank item in GelatoConnect.

If **ProductVariant** is used instead, you must include matching ***VariantAttributeKey\_x*** and ***VariantAttributeValue\_x*** fields to identify the correct variant.

For example, ***VariantAttributeKey\_1*** can be set to Color and ***VariantAttributeValue\_1*** to Black. This means you’re setting “Color” as the first variant, with a value of “Black”.

#### Preparing Your Orders

The following details can be submitted for an order as either checkout data or order metadata.

| **Field Name** | **Field Description**                                                                                                                                                                                                                                                            |
| -------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| OrderType      | Use this field to set the order type. If not set, it will default to `order`.                                                                                                                                                                                                    |
| ShipmentMethod | Use this field to override the shipping class match on an order by order basis. You can set either the GelatoConnect unique identifier (UID) of the shipment method (e.g. `fed_ex_2_day`), the shipping carrier name (e.g. `DHL`), or the shipping option tier (e.g. `Express`). |

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.


---

# 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/gelatoconnect-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.