All Collections
Getting started
Connect your store
Getting Started with WooCommerce
Getting Started with WooCommerce
Updated over a week ago

In this guide, you will find the most important information to get started if you want to integrate your WooCommerce store with Gelato.

Connect WooCommerce store to Gelato - Checklist

  1. Please make sure that your WooCommerce version is 2.4.8 or higher, it’s required for the Gelato app to work properly.

  2. Check that your WooCoomerce store has an HTTPS connection and doesn’t have redirection. This can be checked here.

  3. Make sure that WooCommerce REST API is accessible. This can be verified by going to the .htaccess file and making sure it has this entry: SetEnvIf Authorization "(.*)" HTTP_AUTHORIZATION=$1. For more information, please check these WordPress and Github posts.

Make sure that the checklist is being followed for domains and subdomains.

Enable REST API in your WooCommerce settings

  1. From the Admin Panel of your store, open "WooCommerce → Settings → Advanced".

  2. Under the "Legacy API" tab, "Enable the legacy REST API".

  3. Click "Save Changes".


Make sure that permalink setting are not set to Plain

WooCommerce REST API currently works only when WordPress permalinks are enabled. So in order to use the API, you need to make sure that the Permalink setting is not set to the default value. The permalink feature depends on your server configuration - if URL rewriting is not available, then the permalinks will not work.

  1. Open "Settings → Permalinks"

  2. Under "Common Settings" choose any other link structure other than "Plain" in order for the WooCommerce API to work.

  3. Click "Save Changes".

  4. You can now check if the WooCommerce API is working by opening in the browser. If the response contains JSON code with store information, then the API works, otherwise, the permalinks are not enabled correctly.

Install the Gelato plugin

  1. Go to your WooCommerce site and open up the “Plugins → Add new” in the left menu.

  2. Search, install, and activate the Gelato plugin.


Connect your WooCommerce to Gelato

  1. Open the Gelato tab in the left menu and click “Connect to Gelato”

  2. Allow access to the Gelato plugin


With the Gelato plugin, you can create products, their mockup images, descriptions, and pricing. Start adding your products by going to your connected WooCommerce → Add products.

Setting up Gelato shipping in WooCommerce

  1. Please ensure that the Gelato plugin is installed on your WooCoomerce Store and status of the plugin looks healthy.

  2. To link Gelato's shipping costs and times to your WooCommerce checkout page, activate live shipping rates in the Gelato Shipping section of the WooCommerce settings and ensure all three checkboxes are checked. To do so, go to WooCommerce > Settings > Shipping > Gelato Shipping and enable the Gelato shipping method. Once enabled, Gelato shipping rates will start showing during the checkout for the products fulfilled by Gelato.


Selling customizable products

If you are selling products that require you to change the artwork before fulfilling the order then we recommend that you activate the manual approval workflow. Read more on how to set it up.

Did this answer your question?