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

Resolving Errors When Mapping or Unmapping Products in Webgility Desktop

This article helps Webgility Desktop users resolve errors encountered while mapping or unmapping products in Webgility Desktop. It provides step-by-step instructions to fix common product mapping issues by refreshing product data from connected sales channels.

Causes of Issues:

  • Errors occur when attempting to map or unmap SKUs

  • Outdated or incorrect product data from your sales channel

  • Sync failures between Webgility and connected platforms

Step-by-Step Instructions:

1. Verify Channel Connections

  • Navigate to: Connections > Sales Channel > Manage Sales Channel

  • Ensure all relevant sales channels and QuickBooks are properly connected

2. Download Fresh Product Data

  • Steps to Download the Latest Sales Channel Data & Products

  1. Go to Connections > Sales Channel > Advanced Settings.

  2. Under Application tab, click Clear for Last download date for Store Item, then Save and Close.

  3. Navigate to Connections > Get Latest Data & Settings.

  4. In the popup, click Download Data under Download online store settings.

  5. To refresh products, go to Products > All Products under your Sales Channel, then click the refresh icon.

  • Steps to Download the Latest Accounting Data & Products

  1. Go to Connections > Sales Channel > Advanced Settings.

  2. Clear Last download date for both QuickBooks Items and QuickBooks Customers, then Save and Close.

  3. Navigate to Connections > Get Latest Data & Settings.

  4. Click the dropdown next to Download Data, choose Re-Download All Data.

  5. To download only items, go to Products > All Products (QuickBooks) and click Download Products from Scratch. 


Common Errors & Fixes:

  • Connection Failed: Check login credentials and internet connection

  • Timeout/Error Loading Items: Retry during off-peak hours or reduce batch size

  • Item Not Found: Confirm product still exists in the sales channel and QuickBooks.

Tip: Always select the correct sales channel before downloading to avoid mismatched data.

4. Attempt Product Mapping/Unmapping Again

  • Retry mapping or unmapping SKUs using the updated product list.

  • Confirm if the error still occurs.


Additional Recommendations:

  • Periodically refresh product data after catalog changes

  • Keep a record of manual mappings for future troubleshooting