Go to Dashboard

How can we help?

Popular articles Welcome to Gelato API! Getting Started Guide (Manual Orders) Getting Started Guide (Shopify integration) What hangers are a good fit for my poster size? How can I order a framed poster? What print products do you offer? Where can I find product dimensions? How can I check your product pricing? How does the sign-up promotion work? Can I claim back the VAT of my order? Why do I get charged VAT on some orders and not others? VAT on local printing and delivery within EU In which countries do you have local production? How quickly do you deliver? How do I estimate the pricing 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? Email Notification from Gelato: Order [123] is on hold - Action required Do you offer 24/7 customer support? What is you return policy and quality guarantee? How do I report a problem with my order? 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 shipping method and tracking in the Gelato Dashboard?

How can I migrate Shopify products to Gelato in bulk?

Are you looking to move to Gelato and have hundreds or thousands of products in your store? Then this article is for you. In the dashboard, you are able to connect variants one by one. This is a great way when you have a couple of products and variants that you want to connect. When you have hundreds or more than another approach is needed. 

This guide is for customers who want to have their Shopify products fulfilled via Gelato. 

To bulk migrate the products and variants we will leverage the Bulk Import Products functionality. There is no limit to how many products and variants that can be imported and connected with it in one go. 

What you will need: 

  • A list of all your products and variants in a spreadsheet
  • A mapping between your variants and which product you want Gelato to use to fulfill it
  • A link to the print file for each variant

We are going to make a spreadsheet that in the end will have 5 columns: 

  1. Shopify product title
  2. Shopify product id
  3. Shopify variant id
  4. product uid (i.e. the Gelato product that should be printed)
  5. print file link (i.e. the link to the print file you want to have printed on the product)


Exporting a list of products and variants including variant id

In the regular product export in Shopify, variant ID is not included. Therefore you need to use an app to export a list of all variant ids. There are several in the app store. Here are 2 apps that are able to export the necessary data: Excelify, EZ Exporter. Note that you may be charged for using them. 

The 3 columns that are mandatory to export are Title, Product ID and Variant ID. However, you will want to export a number of additional columns to be able to know what variant it is. 

For example, the default export settings for Products in Excelify returns all necessary fields to be able to identify what each variant is. 

Use your selected app to create a list of all of your products and variants that include the variant ids.


Adding product UID and the print file

Use a spreadsheet software to modify the file you exported in the previous step. Add 2 columns to the sheet:

  • product_uid
  • file_url


Picking the right product_uid

The product_uid represents the product that should be fulfilled when the variant is ordered. To get the product_uid find the product in the catalog that you want to use. Select the right size, color, orientation (or any other dimension) needed. Then scroll down and click on the blue copy icon highlighted in the below screenshot. 


Paste it in your spreadsheet in the cell for product_uid for that specific variant. Repeat until all variants are done. 


Adding a link to the print file

In the column for file_url add a link to your print file. It is important that the link can be accessed without any login or credentials. This is possible to achieve with both Dropbox and Google Drive but a few extra steps are necessary to take. 

Paste the link into the cell of the spreadsheet. The print file can be in PNG, JPEG, or PDF format. Repeat until all variants are done. 


Finalizing the import file

Now you are done with adding all data. The final step is to remove all columns that are not needed so it only has 5 columns left: Title, Product ID, Variant ID, product_uid and file_url. 

Make a copy of your file before you do this so you can easily go back and make further updates.  


Example final structure


Product ID

Variant ID



Sunset Poster











Importing the file

Currently, the import is run by Gelato on request. Share the file with your account manager or Gelato representative. We will check that the file looks structurally ok but we will not make any specific verifications on that you have mapped each product and file correctly. 

The import will then be run and all the variants in the sheet will be connected and start to be automatically fulfilled by Gelato. 


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