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
Order Information 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.

Webhook URL

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

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.

Order Information Settings

Order Metadata Field

Use this field to set comma separated values to be sent as order metadata.

Item Metadata Field

Use this field to set comma separated values to be sent as item metadata.

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.
visibility_x Set a value of 1 to indicate whether or not this file should appear in the list of files on your Gelato dashboard. Must be paired with the matching print_url_x (e.g. print_url_1/visibility_1, print_url_2/visibility_2, and so on).
thread_color_x_x Use to set thread color. Value must be Hex color codes (e.g. #00FFFF, #FF0000, etc.). Must be paired with the matching print_url_x (e.g. print_url_1/thread_color_1_1, print_url_2/thread_color_2_1, and so on). If there is only one print_url for your items, thread_color_x will be an accepted field. Up to 6.
adjust_uid Set a value of 1 to have the product code automatically adjusted based on the file type submitted.
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