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

Troubleshooting WooCommerce Store Module Issues: Updates and Item Sync

This article helps Webgility Desktop users resolve common issues with the WooCommerce Store Module plugin that can cause item synchronization problems, including products not syncing or errors during item creation.

Overview

If you're using Webgility Desktop to manage your WooCommerce items, you might occasionally encounter issues like products not syncing or errors during item creation. This guide provides a step-by-step troubleshooting flow to help you resolve these problems.

Common Symptoms

You might be experiencing issues if you notice:

  • Items that are missing or not synchronizing correctly between Webgility Desktop and your WooCommerce store.
  • Errors appearing when you try to create or update items.

Step-by-Step Troubleshooting

Let's work through these steps to get your item sync running smoothly.

1. Verify Webgility WooCommerce Connector Plugin Version and Activation

Ensuring your Webgility WooCommerce Connector plugin is active and up to date is crucial for proper functionality.

  1. Log in to your WordPress Admin panel.
  2. Go to Plugins > Installed Plugins.
  3. Locate the Webgility WooCommerce Connector in your plugins list.
  4. Confirm that the plugin is active. If it's not active or appears to be outdated, proceed to Step 2 for updating/reinstalling.

2. Update or Reinstall the Webgility WooCommerce Connector Plugin

An outdated plugin is a frequent cause of sync problems.

  1. Download the latest plugin: Grab the newest Webgility/WooCommerce integration plugin file from your Webgility account portal. Log in to portal.webgility.com and head to the Downloads section to find the WooCommerce plugin file.
  2. Log in to your WordPress Admin Dashboard.
  3. Go to Plugins > Installed Plugins.
  4. Deactivate the existing Webgility WooCommerce Connector.
  5. Delete the plugin from the plugins list. (Don't worry, your data won't be lost, but this ensures a clean installation).
  6. Go to Plugins > Add New > Upload Plugin, then choose the file you just downloaded.
  7. Click Install Now, and then Activate the updated module.
  8. Confirm the plugin is now active with the expected latest version.

3. Confirm Successful Item Sync

After applying the above steps, perform a test to ensure items are syncing correctly.

  1. Create or update a test product within Webgility Desktop.
  2. Verify that this product appears and is correct in your WooCommerce store catalog (go to WooCommerce > Products in your WordPress admin panel).
  3. Check sync logs within Webgility Desktop (usually under Help > View Logs) for any recent errors.

Common Connection Issues & How to Fix Them

Beyond item sync, here are other general connection problems that can affect your WooCommerce integration and how to fix them:

Blocked Webgility Extension Access

Your WooCommerce store's security settings (e.g., hosting firewall) might be blocking Webgility from connecting.

  • Solution: Whitelist Webgility IPs To allow Webgility to securely communicate with your store, please whitelist the following IP addresses in your WooCommerce hosting environment:
    • 183.182.84.170
    • 111.118.255.21
    • 54.69.99.71

Incorrect Webgility Extension URL

Entering the wrong URL during setup can cause connection problems.

Incorrect WooCommerce Admin Credentials

Always confirm that you're entering the correct WooCommerce admin username and password when connecting your store in Webgility Desktop.

Outdated Webgility Application

If you've updated your WooCommerce store but not your Webgility Desktop application, you might see errors.

  • To update your Webgility Desktop application:
    • If you're already logged in: Click Help > Check for Updates > Update within Webgility Desktop.
    • If you're unable to log in: Download and install the latest version from portal.webgility.com.

Troubleshooting Error Messages (General)

When you test your store connection in Webgility Desktop (Connections > Sales Channels > Manage Sales Channel > Edit Connection > Test Store Connection), you might see messages like:

  • "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."

🛠 Here's how to fix these errors:

Step 1: Test Your Extension URL in a Browser Paste your Webgility Extension URL directly into your web browser. If you see an error like:

  • 403 Forbidden
  • Page Not Found
  • Access Denied

...then continue to the checklist below.

Step 2: Your 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 Desktop. (Remember: Help > Check for Updates > Update if you're logged in, or download from portal.webgility.com if you can't log in.)
  • ✅ Upgrade to the latest Webgility Extension for WooCommerce if needed (download from portal.webgility.com).

🔄 Verifying Your Webgility Extension Version Paste your Webgility Extension URL into your browser. The version number will be visible at the top of the page. Make sure it matches the latest release available from portal.webgility.com.

Connection Tips

If you're still having trouble connecting:

  • Try adjusting the URL format:
    • Add or remove www.
    • Switch between http and https.

Best Practices

  • Regularly update all your WooCommerce plugins, your WordPress core, and your Webgility Desktop application to avoid compatibility issues.