Gelato Integration

Order Desk can import orders from your shopping cart(s), sync in your print details and then automatically send them to any printer using Gelato. When orders are shipped, the tracking details will be sent back to Order Desk automatically.


Integration Settings
Product Settings
Shipping Class Match
Sending Orders to Gelato


To enable the integration, click on Manage Integrations in the left sidebar. Under the Print on Demand tab, find and enable the Gelato integration. 

Alternatively, search for Gelato from the available integration search.

Enter your Gelato API Key and click to connect.

Please note that Order Desk isn’t able to help find or reset your credentials, as they can only be provided by Gelato.

Integration Settings

Once connected, you'll have some shipment and integration settings to adjust per your preferences.

After Import, Move To

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

You can use one of the default folders already in your store or create your own. Read the Working with Folders guide for more information.

After Shipment, Move To

Select the folder you want orders to be moved into when Gelato sends tracking details back.

Default Mail Class

Choose the shipping class you want Gelato to use for your orders.

If you need to apply specific methods for certain orders, match your method names to the names Gelato uses in the Shipping Class Match section below.

Automatically Approve Submitted Orders

Select this option for Gelato to automatically approve orders, or leave unselected to have Gelato hold orders and wait for manual approval.

This can be changed using OrderType on a per-order basis, details below.

Webhook URL

You will need to set this webhook URL in your Gelato account for Order Desk to download your shipment notifications. 

Product Settings

For more information on what these product settings within the Gelato integration are for, please refer to the Print on Demand Product Settings guide.

Shipping Class Match

Using the shipping class match feature, you can match as many different shipping methods as you offer to the methods Gelato uses to ensure your customers are getting the closest shipping option to what they selected at checkout.

For information on how to set up your shipping preferences, please read the shipping class match guide.

Sending Orders to Gelato

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

Item Details

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

Field Name Field Description
print_sku Required. Gelato's product code for the item.
print_url_x Required. Link to your artwork file. Up to 5 (e.g. print_url_1, print_url_2, etc.).
print_location_x Use to set the location of the print area on the item. Up to 5. Must be paired with the matching print_url_x (e.g. print_url_1/print_location_1, print_url_2/print_location_2, and so on) Default value is default.
page_count Use this field to set the page count for multi-page products.

Customize Order Details

You can add custom details to your orders to be passed through to Gelato. Add these details as checkout data or metadata fields. The field names must be an exact match to this table.

Field Name Field Description
Currency Add the currency code for your order here. Default is USD.
OrderType If this field is blank, Order Desk will check the Automatically Approve Submitted Orders setting. If enabled, the field value will be set to order. If disabled, the field value will be set to draft.

For instructions on how to apply these fields to checkout data, please read the How to Work with Checkout Data guide.

Still need help? Contact Us Contact Us