> 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/gelato-integration.md). # Gelato Integration Order Desk can import orders from your shopping carts, sync your print details, and automatically send them to any printer using [Gelato](https://gelato.pxf.io/c/3419143/1445275/15091). When orders are shipped, the tracking details will automatically be sent back to Order Desk. ### Setup To enable the integration, click **Manage Integrations** in the left sidebar. Under the **Print on Demand** tab, find and enable the Gelato integration. ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2Fu6Nu2UPYg6DBF2ABDjYK%2Flegacy-cdd09ca53e3714d007b7.png?alt=media) Alternatively, search for Gelato using the available integration search. ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FYPKzneIjW9cSAU1K8Kfv%2Flegacy-0bd0a67561f280f5012b.png?alt=media) Enter your Gelato API key and click **Connect**. ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FnxrTFFl6X8EzQp2pZ3Ht%2Flegacy-a16ce413a6e1e5661ae6.png?alt=media) 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 ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2Flqz1fOA4ImHzmUioZwvH%2Flegacy-62cfcc69407940c5593a.png?alt=media) Once connected, you’ll have some shipment and integration settings to adjust based on 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](/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 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 to certain orders, match your method names to the names Gelato uses in the [Shipping Class Match](#shipping-class-match) section below. #### Webhook URL You’ll need to set this webhook URL in your Gelato account so Order Desk can download your shipment notifications. #### Automatically Approve Submitted Orders Select this option to have Gelato automatically approve orders, or leave it unselected to have Gelato hold orders for manual approval. This can be changed on a per-order basis using **OrderType**, as explained [below](#sending-orders-to-gelato). #### Order Information Settings ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FynWbn2I4nSnbNU8wpMAy%2Flegacy-635589351b446ec69df2.png?alt=media) Use this field to set comma-separated values to be sent as order metadata. Use this field to set comma-separated values to be sent as item metadata. #### Inventory Management If you want Order Desk to sync stock status from Gelato, you can set that up here. ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FryidrzaSrdBXHYGDgE3V%2Flegacy-2538ad3d6c3f5adc0bf9.png?alt=media) #### Sync Inventory Enable this setting if you want Order Desk to download stock availability from Gelato. #### Sync Stock From Region Choose the specific region you’d like Order Desk to check for stock updates from Gelato. #### In-Stock Quantity When Gelato confirms that an item is in stock, the value entered here will be used as its stock count in Order Desk. #### Product Settings ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FLxkPasv9MNHHsnoDcg6b%2Flegacy-1a56116d4c52517cd04f.png?alt=media) #### Shipping Class Match ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FakJoPvxXg5HDAd3KbETi%2Flegacy-06fee6d782b8692b9b42.png?alt=media) For information on how to set up your shipping preferences, read the [Shipping Class Match](/guided-walkthroughs/shipping-fulfillment-and-returns/how-to-set-up-shipping-class-matches.md) guide. ### Sending Orders to Gelato Getting your orders ready to send to Gelato will take some setup time. For a detailed walkthrough of how to use Order Desk with your print-on-demand orders, read the [Print on Demand Fulfillment](/guided-walkthroughs/print-on-demand-walkthrough/print-on-demand-fulfillment.md) 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.** A link to your artwork file. Up to five files can be submitted using fields such as print\_url\_1 and print\_url\_2. | | print\_location\_x | Sets the location of the print area on the item. Up to five can be submitted. Each field must be paired with the matching print\_url\_x field, such as print\_url\_1/print\_location\_1 or print\_url\_2/print\_location\_2. The default value is **default**. | | visibility\_x | Set the value to 1 if the file should appear in the list of files on your Gelato dashboard. Each field must be paired with the matching print\_url\_x field, such as print\_url\_1/visibility\_1 or print\_url\_2/visibility\_2. | | thread\_color\_x\_x | Sets the thread color. Values must be hex color codes, such as #00FFFF or #FF0000. Each field must be paired with the matching print\_url\_x field, such as print\_url\_1/thread\_color\_1\_1 or print\_url\_2/thread\_color\_2\_1. If an item only has one print URL, thread\_color\_x is also accepted. Up to six thread colors can be submitted. | | adjust\_uid | Set the value to 1 to have the product code automatically adjusted based on the submitted file type. | | page\_count | Sets 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 exactly match those shown in the table below. | Field Name | Field Description | | ---------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Currency | Sets the currency code for the order. The default is USD. | | OrderType | If this field is blank, Order Desk will check the **Automatically Approve Submitted Orders** setting. If the setting is enabled, the field value will be set to **order**. If it is disabled, the field value will be set to **draft**. | For instructions on how to apply these fields as checkout data, read 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/gelato-integration.md?ask=&goal= ``` `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.