If a third-party app — a payment gateway, a CRM, a time-tracking tool, an e-commerce platform — needs to sync data with your QuickBooks Desktop company file, chances are it’s asking you to install something called Web Connector first. It’s not an app in the usual sense. It’s more like a quiet middleman: it sits on your computer, checks in with QuickBooks and your connected app on a schedule you set, and moves data back and forth without you doing anything manually.
It’s also one of those tools that’s simple once it’s running and mildly baffling the first time you set it up, mostly because the terminology (qbXML, .qwc files, “Manage Web Apps”) isn’t exactly self-explanatory. This guide walks through what it actually does, how to install and configure it correctly, and how to fix the errors that come up most often.
What Does QuickBooks Web Connector Actually Do?
In plain terms: it lets a web-based application exchange data with your locally installed QuickBooks Desktop company file, automatically, on a schedule. You don’t have to export a report and re-import it somewhere else — the connected app and QuickBooks handle the exchange between themselves once it’s configured.
It’s genuinely just a Windows program, provided free by Intuit, that’s part of the QuickBooks Desktop SDK ecosystem. A few things worth knowing about how it works under the hood:
- It has to run on the same computer or local network as QuickBooks Desktop — it can’t reach across the internet to a QuickBooks installation somewhere else.
- It’s the one initiating the connection, not the other way around, so you don’t need to open any firewall ports for it to work — a common early worry that turns out to be unnecessary.
- The data itself moves in a format called qbXML (or qbposXML for Point of Sale), which is the same underlying format the QuickBooks Desktop SDK uses.
Common reasons you’d actually need this: connecting a Tax1099 e-filing service, syncing a Shopify or WooCommerce store’s orders into QuickBooks, linking a CRM or project management tool, pulling time-tracking data into payroll, or connecting a payment processor that isn’t natively built into QuickBooks. If a third-party app’s setup instructions mention a “.qwc file,” that’s your sign you’ll be using Web Connector.
Does QuickBooks Online Use Web Connector?
No — and this trips people up regularly. Web Connector is a Desktop-only tool. QuickBooks Online connects to third-party apps through its own App Store and API instead, since it’s cloud-based to begin with and doesn’t need a local middleman to reach the internet. If you’re on QBO and a setup guide is telling you to install Web Connector, you’re likely looking at instructions written for Desktop users by mistake.
System Requirements
Web Connector is a Windows-only application — it doesn’t run on macOS. If you’ve seen instructions online for “removing Web Connector on Mac,” that’s a mix-up; there’s no Mac version to remove.
- Windows 10 or 11 (or a supported Windows Server edition)
- QuickBooks Desktop installed on the same machine or local network
- .NET Framework (the installer will prompt you if a required version is missing)
- Administrator rights on the computer, for both install and setup
- A stable internet connection, since the connected app itself lives on the web
Which QuickBooks Versions Does Web Connector Support?
Web Connector versions are tied fairly specifically to QuickBooks Desktop versions, which is the part people miss most often.
| QuickBooks Desktop Version | Web Connector Version |
|---|---|
| 2024 | 34.0.10010.76 |
| 2023 | 33.0.10015.91 |
| 2022 | 32.0.10018.93 |
| 2021 | 31.0.10015.29 |
If you have more than one QuickBooks Desktop version installed side by side, install the Web Connector version that matches the newest one — it’ll work with the older installations too. And per Intuit’s own current guidance: always download the latest available version, even if your QuickBooks Desktop itself is a bit older, since Web Connector updates often patch security certificates independently of QuickBooks version releases.
Broader compatibility, by Web Connector generation:
- Version 2.2.0.34 and newer — supports TLS 1.0, 1.1, and 1.2. Works with QuickBooks Pro, Premier, Enterprise Solutions, and the Canadian/UK editions, 2015 and later.
- Version 2.1.0.30 and older — supports only TLS 1.0. Works with older QuickBooks Pro/Premier (2002+), Enterprise Solutions, QuickBooks Point of Sale (v4.0+), and older Canadian/UK editions.
Unless you have a specific reason to use an older version, go with the current one — older TLS-only versions are increasingly likely to fail against modern secure servers.
How to Download and Install Web Connector
- Go to Intuit’s official developer download page and grab the version matching your QuickBooks Desktop year (or the newest, per the note above).
- Right-click the downloaded ZIP file and choose Extract All.
- In the extracted folder, right-click QBWebConnectorInstaller.exe and select Run as Administrator — skipping this is a common reason installs silently fail.
- Work through the installer prompts: allow the app to make changes, accept the license agreement, and click Install.
- Click Finish once it completes.
If Installation Throws an Error
Before doing anything else, open Task Manager (Ctrl+Shift+Esc), look for any running QuickBooks Web Connector process, and end it — trying to reinstall over a process that’s still technically running is a frequent, easy-to-miss cause of installation errors.
If that doesn’t clear it, uninstall and reinstall cleanly:
- Press Windows + R, type
control, and press Enter. - Select Uninstall a Program, find Web Connector, and uninstall it.
- If it doesn’t appear in the list, manually delete the QBWebConnector folder from
C:\Program Files (x86)\Common Files\Intuit\QuickBooks\orC:\Program Files\Common Files\Intuit\QuickBooks\. - Reinstall using the steps above.
If you’re also running into a numbered installer error during this process — Error 1304 is a fairly common one tied to Windows failing to write installer files correctly — it’s worth resolving that separately before retrying Web Connector’s install.
Setting Up Web Connector and Adding Your First App
Once it’s installed, connecting an app requires a .qwc file, which comes from the third-party application itself, not from QuickBooks or Intuit. If you don’t have one yet, that’s the first thing to get from the app’s own setup instructions or support team — Web Connector has nothing to connect to without it.
- Open QuickBooks Desktop and log in as the Admin user.
- Double-click the .qwc file you received from the third-party app.
- A prompt will ask you to authorize the new web service — select OK.
- This opens Web Connector’s Manage Web Apps screen, showing the app you’re adding.
- Select Set up, which takes you to the app’s own website to log in and authorize the connection there.
- Once authorized on the app’s side, return to QuickBooks and select Done on the access confirmation prompt.
That completes the connection — the app should now appear in Web Connector’s app list, ready to sync.
Setting the Sync Schedule
This part gets skipped in a lot of setup guides, but it’s genuinely important: in the Web Connector window, each connected app has an “Auto-Run every ___ minutes” checkbox and field next to it. Leave it unchecked, and syncing only happens when you manually open Web Connector and click Update. Check it and set an interval, and it’ll sync automatically in the background at whatever frequency you choose.
For most small businesses, a sync interval somewhere between 15 minutes and a few hours is reasonable — how time-sensitive the data is should drive the number, not a desire to sync as fast as technically possible, since more frequent syncing means more background load on your computer.
Managing, Transferring, and Removing Apps
To check or adjust an app’s settings: File > App Management > Manage Web Apps, then select the app to view or change its configuration. If an app installed fine but isn’t actually syncing data, it’s worth checking Edit > Preferences > Integrated Applications > Company Preferences to confirm the app has been granted Read/Write access — a connection can succeed while permissions quietly stay too restrictive for the sync itself to work.
To move an app’s connection to a new computer (say, you’re upgrading hardware): File > App Management > Manage Web Apps > Connected Apps, then select Transfer App to My Device from the new machine. Note that this severs the connection on the old computer — it doesn’t create a second active link. If you’re planning a broader move to a new computer rather than just this one connection, our guide on the QuickBooks Migration Tool covers moving QuickBooks itself, which you’ll likely want to do first.
To remove an app entirely: Edit > Preferences > Integrated Applications > Company Preferences, select the app, and click Remove. This stops the data exchange completely — reconnecting later means running through the .qwc setup again.
Common QuickBooks Web Connector Errors
| Error | What’s Usually Going On | Fix |
|---|---|---|
| QBWC1006 | Web Connector can’t locate the company file | Verify the file path and permissions, check the QWCLOG.txt file for specifics, then restart Web Connector |
| QBWC1005–1009 | Log file issues, often after QuickBooks stops responding mid-sync | Confirm QuickBooks is fully updated, verify file permissions, then reopen the file |
| QBWC1018 | Web Connector can’t find a linked application | Close and reopen Web Connector, confirm the correct QuickBooks company file is selected |
| QBWC1085 | The log file can’t be written to, or is corrupted | Close both QuickBooks and Web Connector, rename the existing log.txt to log.txt.old, then restart Web Connector |
| QBWC1040 | Incorrect or missing password | Re-enter the password carefully; if it’s genuinely lost, most connected apps have their own password reset flow |
| QBWC1022–1024 | Web Connector can’t establish a connection with QuickBooks | Restart QuickBooks, update if needed, then reopen the company file before retrying |
| QBWC1038 | Incorrect master password (the key protecting all your saved app passwords) | Re-enter it carefully, or use the “forgot master password” option to regenerate it |
Stop Antivirus and Firewall Software From Blocking It
Since Web Connector runs quietly in the background, security software occasionally flags it or blocks its outbound connection without a clear warning. If syncs are silently failing with no obvious error, check that these are allowed through your antivirus and firewall:
QBWebConnector.exeQBWCTaskScheduler.exe
Both typically live under C:\Program Files (x86)\Common Files\Intuit\QuickBooks\QBWebConnector\.
A Note for Tax1099 Users
If you’re using Web Connector to import 1099-NEC or 1099-MISC forms through Tax1099, there’s a formatting quirk worth knowing about: as of recent tax seasons, your Tax1099 password in Web Connector needs a dash plus a capital N or M appended — N for 1099-NEC, M for 1099-MISC. So a password like Test6789! becomes Test6789!-N when importing NEC forms. It’s an easy thing to overlook and a common reason this specific integration throws a login error even when the base password is correct. If your broader payroll and contractor setup is also giving you trouble around tax season, our payroll support guide covers the more common causes.
When to Get Help
Most Web Connector issues come down to the process not being killed before reinstalling, a mismatched version, or permissions not being granted correctly — all fixable without outside help. But if a connected app has been failing to sync for a while and you’re not confident the data on both sides still matches up, it’s worth having someone verify that directly rather than assuming everything’s caught up once the error disappears.
Our team at Data Service Solutions can help set up, troubleshoot, or untangle a misbehaving Web Connector integration. Call +1 (855) 955-1942 for support.
Frequently Asked Questions
Does QuickBooks Web Connector work with QuickBooks Online?
No. Web Connector is built specifically for QuickBooks Desktop. QuickBooks Online connects to third-party apps through its own App Store and API instead.
Do I actually need Web Connector, or can I skip it?
Only if a third-party app you’re using requires it. It’s not something QuickBooks needs on its own — it exists specifically to let external web-based apps sync with your Desktop company file.
Is QuickBooks Web Connector free?
Yes, it’s a free download from Intuit. There’s no license fee for the tool itself, separate from whatever the connected third-party app charges.
Does Web Connector need to stay running at all times?
Only if you want automatic syncing via the Auto-Run interval. Without that checked, it only syncs when you manually open it and click Update.
Does QuickBooks Web Connector work on Mac?
No. It’s a Windows-only application. Mac users connecting third-party apps to QuickBooks need to go through whichever integration method that specific app supports for Mac, since Web Connector itself isn’t available there.
Can one Web Connector installation handle multiple connected apps?
Yes. Each app you add shows up separately in the Manage Web Apps list, with its own settings and its own sync schedule.
How do I open a .qwc file if double-clicking doesn’t do anything?
Confirm Web Connector is actually installed first. If it is, right-click the .qwc file and choose Open With, then select Web Connector directly if it’s not registered as the default handler.
Why does Web Connector keep asking for my password every time it syncs?
This usually means the “remember password” option wasn’t selected during setup, or your Windows credential store isn’t saving it properly. Re-entering it and confirming the save option is checked usually resolves it.
