Fixing “Error Connecting to Webgility Extension” in Webgility Online

Common Reasons for Sync Failures

You may encounter sync or connection errors for the following reasons:

• Outdated Webgility Extension: An older version can cause compatibility and connection failures.
  
  
• Inactive Webgility Extension Connection: If WDE isn’t running or connected, sync functions won’t work.
  
  
• Disconnected QuickBooks Company File: If the linked file has changed or become disconnected, sync will fail.
  
  

Step-by-Step Resolution Guide

Step 1: Update the Webgility Extension

First, make sure you're running the latest version of the Webgility Desktop Extension (WDE).

1. Exit the current extension
   
   
   • Right-click the Webgility icon in the system tray.
     
     
   • Choose Exit.
     
     
2. Download and install the latest version
   
   
   • Get the newest installer from Webgility Support.
     
     
   • Open your Downloads folder and double-click WebgilityExtensionInstaller.exe.
     
     
   • Click Run when prompted.
     
     
   • If asked to reinstall, click Yes.
     
     
   • Follow the prompts:
     
     
     • Accept the license agreement
       
       
     • Confirm the install location
       
       
     • Leave the desktop shortcut checked
       
       
   • Click Install.
     
     
   • When finished, click Finish (ensure “Launch Webgility” is checked).
     
     

Step 2: Check the Webgility Extension Connection

After updating, confirm that the Webgility Extension is actively connected.

1. Open the Webgility Extension (WDE).
   
   
2. On the Home screen, look for a green checkmark—this means the connection is active.
   
   
3. If not connected:
   
   
   • Locate the Webgility icon in your system tray.
     
     
   • Right-click and select Manual Sync to re-establish the connection.
     
     

Step 3: Verify the QuickBooks Desktop Connection

If orders or transactions are still not syncing, confirm your QuickBooks company file is properly linked.

1. Locate the Webgility Extension icon in your system tray.
   
   
2. Right-click and choose Connect to QuickBooks.
   
   
3. Check the selected company file:
   
   
   • If incorrect, select the correct .QBW file.
     
     
4. Click Test QuickBooks Connection to validate the link.
   
   

Additional Tips

• Always run QuickBooks as administrator before attempting a connection.
  
  
• Make sure QuickBooks is in Single-User Mode when setting up or testing the link.
  
  
• Ensure Webgility Extension starts automatically with Windows for uninterrupted syncing.
  
  
• If using firewall or antivirus software, whitelist the Webgility extension to prevent connection blocks.