Skip to content
  • There are no suggestions because the search field is empty.

How to Troubleshoot WooCommerce Sales Channel Connection Issues in Webgility Desktop

This article helps Webgility Desktop users troubleshoot common WooCommerce connection issues during setup or sync. Problems may include blocked IP addresses, incorrect login credentials, or mismatched extension versions, and the guide provides steps to resolve them.

 

Overview

Webgility integrates seamlessly with WooCommerce to help sync your ecommerce operations. However, issues can sometimes arise during setup or sync, such as blocked IPs, incorrect login details, or extension version mismatches. This guide will help you resolve the most common connection problems.

Blocked Webgility Extension Access

WooCommerce's security settings may block access to the Webgility Extension, causing connection failures.

Solution: Whitelist Webgility IPs

Please whitelist the following IP addresses in your WooCommerce hosting environment:

 
CopyEdit
183.182.84.170
111.118.255.21
54.69.99.71

Whitelisting these will allow Webgility to communicate with your store securely.

Other Common Connection Issues

1. Incorrect Webgility Extension URL

Using the wrong URL during the connection process can cause failures.

  • Double-check that you're entering the correct Webgility Extension URL.

  • Follow the appropriate connection steps for your platform:

    • Webgility Desktop

    • Webgility Online

2. Incorrect WooCommerce Admin Credentials

Make sure you are entering your WooCommerce admin username and password when connecting your store in Webgility.

3. Outdated Webgility Extension

If you've updated your WooCommerce store but not the Webgility Extension, you may see:

  • 403 Forbidden

  • 500 Internal Server Error

📥 Download the latest Webgility WooCommerce Extension from portal.webgility.com and follow the installation instructions to update.

  • In the WooCommerce admin, go to Plugins > Add New > Upload Plugin and select the update package.
  • Click Install Now and then Activate the updated module.
  • Confirm successful update under Plugins list.

🔍 Troubleshooting Error Messages

To test and manage your store connection:

  1. Go to Connections > Sales Channels > Manage Sales Channel > Edit Connection in Webgility.

  2. Enter your Webgility Extension URL, WooCommerce admin username, and password.

  3. Click Test Store Connection.

You might see one of the following messages:

  • “We are facing an issue while processing your request. Please try again later.”

  • “The remote server returned an error. (501) Service Temporarily Unavailable.”

  • “Not able to connect to WooCommerce.”

🛠 How to Fix These Errors

Step 1: Test Extension URL in Browser

Paste your Webgility Extension URL into your browser. If it returns an error like:

  • 403 Forbidden

  • Page Not Found

  • Access Denied

Continue with the steps below.

Step 2: Checklist to Resolve Access Errors

  • ✅ Ensure the following IPs are whitelisted:
    183.182.84.170, 111.118.255.21, 54.69.99.71

  • ✅ Confirm that your Webgility files on your hosting server have Read/Write/Modify permissions.

  • ✅ Make sure you’re using the latest version of Webgility.

    • If you're already logged in:
      Go to Help > Check for Updates > Update

    • If you're unable to log in:
      Download the latest version from portal.webgility.com

  • ✅ Upgrade to the latest Webgility Extension for WooCommerce if needed.

🔄 Verifying Webgility Extension Version

  1. Paste the Webgility Extension URL into your browser.

  2. The version number will be visible at the top of the page.

  3. Ensure it matches the latest release available from portal.webgility.com.

🌐 Connection Tips

If you’re still having trouble connecting:

Try modifying the URL format:

  • Add or remove www

  • Switch from http to https or vice versa