Go to Dashboard

How can we help?

Popular articles Welcome To Gelato! Getting Started with Manual Orders Getting Started with Shopify Getting Started with Etsy Getting Started with WooCommerce Getting Started with Wix Getting Started with Squarespace Getting Started with BigCommerce Why do Packaging Insert and Branded Label matter? Don’t they just increase costs? Are Packaging Insert and Branded Label available with all subscription plans? Are Packaging Insert and Branded Label available for all products and regions? Can I select to deliver Packaging Insert and Branded Label only to a specific country? Can I activate a Packaging Insert and/or Branded Label at a product type level (e.g. Poster) or at a variant level (e.g. Museum-Quality Matte Paper Poster)? How can I check your product price? What is the design editor? What are the design requirements for PDF uploads? How can I save my design in Gelato? How does the integration with Getty Images work? How does the integration with Shutterstock work? What print products do you offer? What's the difference between Ready-to-Hang Framed Posters and Framed Posters? Frames & Hangers - Stock Status Why do I get charged VAT/tax on some orders and not others? How do I add Gelato products to my Shopify store? How do I move my existing Shopify products to Gelato? How can I import orders from Shopify? How can I order customized designs through Shopify? Can I add a new variant to an existing product in Shopify? How can I delete a product or variant from my Shopify store? How do I set up shipping in Shopify? Why aren't my customers charged an extra shipping fee for additional items (Shopify)? How do I automatically apply Gelato live shipping prices to my Shopify store? How can I disable the vendor name under the product title in Shopify? How do I add Gelato products to my Etsy store? How do I move my existing Etsy listings to Gelato? How can I order customized designs through Etsy? How can I delete a product or variant from my Etsy store? How do I set up shipping for Etsy? What should I set the shipping origin to in the shipping profiles for Etsy? Do I have to list Gelato as a production partner on Etsy? How Can I Import Orders From WooCommerce? How do I add Gelato products to my WooCommerce store? How do I move my existing WooCommerce products to Gelato? How can I order customized designs through WooCommerce? Can I add a new variation to an existing product in WooCommerce? How can I delete Gelato products from my Woocommerce store? How do I set up shipping for WooCommerce? How do I automatically apply Gelato live shipping prices to my WooCommerce store? How can I import orders from Wix? How can I import orders from Squarespace? How can I import orders from BigCommerce? Where do you print locally? How quickly do you deliver? How do I estimate the price for shipping? Where can I find the flat rates for shipping? How do I see where a specific product is being printed? I receive an error message when I try to place an order. What should I do? How do I place a manual order via the Gelato Dashboard? How do I check the order status in the Gelato Dashboard? How do I check estimated delivery date and tracking in the Gelato Dashboard? What is the manual order approval workflow? What is our default order approval workflow? Email Notification from Gelato: Order [123] is on hold - Action required Holiday order deadlines How do I contact Gelato? Do you offer 24/7 customer support? What is your return policy and quality guarantee? How do I report a problem with my order? Gelato+ limited holiday offer: free shipping for the rest of 2022! What is Gelato+? Gelato+ Subscription FAQs

What is a product UID?

A product UID is a unique identifier used by our global network of print partners to figure out how to print the files you send via the Gelato API. It is therefore essential that you understand the logic behind product UIDs and correctly map the formats and paper types you intend to send over.

Below you will find a detailed explanation of the components of a product UID with several examples to better understand the concept.

The full list of product UIDs for the products that we support can be found in the Product Catalog of the API Portal.

Product UID structure

A product UID is a string of text made of different parts to identify the product in its entirety. The most important parts are:

Note: Please note that not all these parts are mandatory for each product (e.g. there is no "binding type" for flat formats). 

Product category

The first part of the UID indicates the product category, e.g. "cards", "flyers", "brochures", etc.

Examples:

  • cards_pf_bb_pt_350-gsm-coated-silk_cl_4-0_ct_matt-protection_prt_1-1_hor
  • brochures_pf_a4_pt_350-gsm-coated-silk_cl_4-4_ft_fold-ver_ct_glossy-protection_prt_1-1_ver

Paper format

pf is the paper format, e.g. “bb” or "A4"

Examples:

  • cards_pf_bb_pt_350-gsm-coated-silk_cl_4-0_ct_matt-protection_prt_1-1_hor
  • brochures_pf_a4_pt_350-gsm-coated-silk_cl_4-4_ft_fold-ver_ct_glossy-protection_prt_1-1_ver

Note: More information on paper formats and dimensions is available here.

Paper type

pt is the paper type, e.g. “350-gsm-coated-silk” or "130-lb-cover-coated-silk"

Examples:

  • cards_pf_bb_pt_350-gsm-coated-silk_cl_4-0_ct_matt-protection_prt_1-1_hor
  • brochures_pf_a4_pt_130-lb-cover-coated-silk_cl_4-4_ft_fold-ver_ct_glossy-protection_prt_1-1_ver

Note: For multipage products, this attribute indicates the paper type for the inner pages. Paper type for cover pages is specified in the attribute cpt. Also, "lb" standard is used in North America while the rest of the world uses "gsm". 

Print sides

cl indicates the coloured sides: e.g. “4-4” (printed on both sides) or "4-0" (printed on one side)

Examples:

  • cards_pf_bb_pt_350-gsm-coated-silk_cl_4-0_hor
  • brochures_pf_a4_pt_350-gsm-coated-silk_cl_4-4_ft_fold-ver_ver

Binding type

bt indicates the binding type: e.g. “glued-left” (glue binding on the left side), "wire-o-left" (wire-o binding on the left side) or "stitched-left" (saddle-stitched on the left side)

Examples:

  • glued-multi-page-brochures_pf_a4_pt_100-lb-text-coated-silk_cl_4-4_bt_glued-left_cpt_100-lb-cover-coated-silk_hor
  • wire-o-multi-page-brochures_pf_a5_pt_100-lb-text-coated-silk_cl_4-4_bt_wire-o-left_cpt_130-lb-cover-coated-silk_ver
  • stitched-multi-page-brochures_pf_a5_pt_170-gsm-coated-silk_cl_4-4_bt_stitched-left_ct_glossy-protection_prt_1-1_cpt_250-gsm-coated-silk_ver

Note: This attribute is applicable only to multipage products.

Cover paper type

cpt indicates the cover paper type: e.g. “100-lb-cover-coated-silk” or "250-gsm-coated-silk"

Examples:

  • glued-multi-page-brochures_pf_a4_pt_100-lb-text-coated-silk_cl_4-4_bt_glued-left_cpt_100-lb-cover-coated-silk_hor
  • wire-o-multi-page-brochures_pf_a5_pt_100-lb-text-coated-silk_cl_4-4_bt_wire-o-left_cpt_130-lb-cover-coated-silk_ver
  • stitched-multi-page-brochures_pf_a5_pt_170-gsm-coated-silk_cl_4-4_bt_stitched-left_ct_glossy-protection_prt_1-1_cpt_250-gsm-coated-silk_ver

Note: This attribute is applicable only to multipage products. In this case the attribute pt indicates the paper type for inner pages.

Fold type

ft is the fold type (if any), e.g. “fold-ver” (single-folded vertical), "fold-hor" (single-folded horizontal), "8pp-roll-fold-ver" (8-folded vertical), "three-fold-hor" (three-folded horizontal)

Examples:

  • brochures_pf_a4_pt_350-gsm-coated-silk_cl_4-4_ft_fold-ver_ct_glossy-protection_prt_1-1_ver
  • three-fold-brochures_pf_a4_pt_100-lb-cover-coated-silk_cl_4-4_ft_three-fold-ver_ct_glossy-protection_ver

Note: This attribute is applicable only to folded products. 

 

Coating type

ct is the coating type (if any), e.g. “glossy-protection” or "matt-protection"

Examples:

  • cards_pf_bb_pt_350-gsm-coated-silk_cl_4-0_ct_matt-protection_prt_1-1_hor
  • brochures_pf_a4_pt_350-gsm-coated-silk_cl_4-4_ft_fold-ver_ct_glossy-protection_prt_1-1_ver

More information on coating can be found here.

Protection sides

prt indicates the protection sides, e.g. “1-1” (protection on both sides) or "1-0" (protection on one side only)

Examples:

  • cards_pf_bb_pt_350-gsm-coated-silk_cl_4-0_ct_matt-protection_prt_1-1_hor
  • brochures_pf_a4_pt_350-gsm-coated-silk_cl_4-4_ft_fold-ver_ct_glossy-protection_prt_1-0_ver

Note: For multipage products, this attribute applies only to the cover pages. 

Artwork orientation

hor/ver is the artwork orientation, e.g. vertical or horizontal

Examples:

  • cards_pf_bb_pt_350-gsm-coated-silk_cl_4-0_ct_matt-protection_prt_1-1_hor
  • brochures_pf_a4_pt_350-gsm-coated-silk_cl_4-4_ft_fold-ver_ct_glossy-protection_prt_1-1_ver

You can find the product UIDs for all the products we support by accessing the Product Catalogue from the API portal.

Note: For multipage product, the number of pages should not be included in the product UID but sent separately as an attribute. Read more here.

Was this article helpful?
0 out of 2 found this helpful