search
Ctrlk
Raise an IssueJoin Community

Resolving QuickBooks Web Connector Error Company File is Locked by Another client

Error: QuickBooks Web Connector Error – “Company file is locked by another client”

hashtag
Summary

This article provides steps to troubleshoot and resolve the QuickBooks Web Connector error:

Update aborted. The company file is locked by another client.

This issue typically occurs in environments where QuickBooks is hosted on a shared or remote server, such as Right Networks, Intuit Cloud, or Cloud9.

hashtag
Problem

Users receive the following error in QuickBooks Web Connector (QBWC):

Update aborted. The company file is locked by another client.

This prevents the sync process from completing successfully.

hashtag
Applies To

  • Product/Service: DBSync, QuickBooks Web Connector (QBWC)

  • Versions: All versions of QuickBooks and Web Connector

  • Operating Systems: Windows Server environments

  • Hosting Platforms: Right Networks, Intuit Cloud or any other remote QuickBooks hosting provider

  • Applies To: Multi-user QuickBooks environments

hashtag
Solution

Prerequisites:

  • Admin access to the QuickBooks company file

  • Access to the hosting environment (if applicable)

  • All users notified to log out of QuickBooks

Steps:

  1. Log Off All Users

  • Instruct all bookkeepers or QuickBooks users to log off from QuickBooks on all devices.

  • Confirm that QuickBooks is not running in the background (e.g., using Task Manager to end qbw32.exe if necessary).

  1. Restart QuickBooks on the Host

  • Restart the QuickBooks application on the server or remote desktop environment.

  • If hosted (e.g., by Right Networks or Intuit Cloud), ensure the hosting provider fully restarts the QuickBooks session.

  1. Log In as Admin in Single-User Mode

  • Launch QuickBooks.

  • Log in as Admin and switch to Single-User Mode.

  • Launch QuickBooks Web Connector and attempt to sync 2–3 times manually.

  1. Switch Back to Multi-User Mode

  • Once the sync completes successfully, switch QuickBooks to Multi-User Mode.

  • All users can now log back in and resume work as usual.

hashtag
Workaround (If Applicable)

If users were auto-logged out by the Windows Server (common in hosted environments), Windows may still retain a file lock. In such cases:

  • Wait 30 to 60 minutes for Windows to automatically release the file lock.

  • Then repeat the steps above.

hashtag
Root Cause

The error occurs when the QuickBooks company file is in use in a way that prevents other applications (like QBWC) from accessing it.

Common causes include:

  • A user working in Single-User Mode.

  • A system session being auto-logged out while QuickBooks was open.

  • Stale file locks left behind by closed or disconnected sessions on hosted environments.

hashtag
Additional Information / Related Articles

Last updated