This article provides a comprehensive guide to integrating your WooCommerce store with Gelato. It outlines the necessary steps, from ensuring compatibility to connecting your store and adding products.
Before You Begin
Currently, our WooCommerce integration does not support Namecheap hosting. We recommend using alternative hosting providers to ensure compatibility and optimal performance.
Before diving into the integration process, make sure your WooCommerce store meets the following requirements:
WooCommerce version 2.4.8 or higher is installed.
Your store has an HTTPS connection without redirection (verify here).
WooCommerce REST API is installed and accessible:
Use the following link to install WooCommerce Legacy REST API or locate it in WooCommerce plugin section
Go to your .htaccess file.
Ensure it includes the following entry: SetEnvIf Authorization "(.*)" HTTP_AUTHORIZATION=$1
For more details, refer to these resources:
These checks apply to both domains and subdomains.
Enabling REST API in WooCommerce
Access your store's Admin Panel.
Navigate to "WooCommerce → Settings → Advanced".
Go to the "Legacy API" tab.
Enable "Enable the legacy REST API".
Save your changes.
Configuring Permalinks
For the WooCommerce REST API to function correctly, ensure your permalink settings are not set to "Plain".
Go to "Settings → Permalinks" in your WordPress dashboard.
Under "Common Settings," select a link structure other than "Plain".
Save your changes.
Verify API functionality by visiting: http://your-site-url-here.com/wc-api/v1/ (replace with your actual site URL). If you see JSON code with store information, the API is working.
Installing the Gelato Plugin
In your WooCommerce admin panel, navigate to "Plugins → Add New".
Search for "Gelato", then install and activate the plugin.
Connecting WooCommerce to Gelato
Go to the new "Gelato" tab in your WooCommerce left menu.
Click "Connect to Gelato".
Grant the necessary permissions for the Gelato plugin to access your store.
Adding Products
With the Gelato plugin connected, you can now add products, create mockups, set descriptions, and define pricing directly from your WooCommerce dashboard.
Go to your WooCommerce dashboard.
Click on "Add products".
For detailed instructions on adding products, refer to this guide.
Setting Up Gelato Shipping
Make sure the Gelato plugin is installed and active.
To display Gelato's shipping rates and delivery times on your WooCommerce checkout page, enable live shipping rates. Go to WooCommerce > Settings > Shipping > Gelato Shipping and enable the Gelato shipping method.
Selling Customizable Products
If your products require artwork adjustments before fulfillment, activate the manual approval workflow. This allows you to review and approve designs before they're sent to production. Learn more about setting up the manual approval workflow.