Gelato Integration


Integration Settings
Product Settings
Shipping Class Match
Sending Orders to Gelato


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.

This guide will go over the Gelato integration settings and features.


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 Required. Link to your artwork file.
option_print_sku_1 Set values for option_print_sku_1 or option_print_sku_2 if you're adding any extra options for your product.
option_type_1 Use option_type_1 or option_type_2 to set the type of any additional products being included in this shipment.
option_quantity_1 Set option_quantity_1 or option_quantity_2 with a quantity number of how many items will be printed.

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 Default comes from the Automatically Approve Submitted Orders setting above. To override the default on specific orders, set to order for automatic approval or approval_request for manual approval.

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