Add As A Preferred
October 26, 2026
32 min read mins read 
0 Comments Last updated: 26 Oct, 2026. Reviewed by Rajat, eBetterBooks Technical Content Manager.
Key Takeaways
.qbb file under a new name.QuickBooks migration failed unexpectedly is a message from the QuickBooks Desktop Migrator Tool, which moves QuickBooks and your recent company files to a new computer with a USB drive. Stop, leave the old computer as it is, back up the company file, then work through the checks on this page. Two failed runs mean a manual move.
Migrator Tool stopped and short on time? Call 1-802-778-9005 or send the details with the no-login form on this page: the exact message, your QuickBooks version (press F2 on the old computer), the Windows version on the new computer, and whether you have a backup. Support hours: Monday through Friday, 24 hours a day.
QuickBooks migration failed unexpectedly: recovery order from backup to checks, one retry, the stopping rule, manual move and registration
QuickBooks migration failed unexpectedly means the Migrator Tool stopped before it finished moving QuickBooks to a new computer or drive. Pages about other kinds of migration use the same words, so first confirm where you saw it. This page covers the tool you start with File, Utilities, Move QuickBooks to another computer.
In this guide, the old computer is the one you are moving from and the new computer is the one you are moving to. The version is the QuickBooks year and edition that Product Information (F2) shows, for example Pro Plus 2023.
| Where you saw it | What it is | Where to go |
|---|---|---|
| After Move QuickBooks to another computer on the old computer, or after Move_QuickBooks.bat on the new one | A Migrator Tool failure | This page |
| While moving QuickBooks to a new drive on the same computer with the tool | A Migrator Tool failure | This page |
| While moving from QuickBooks Desktop to QuickBooks Online | A Desktop to Online conversion problem | Desktop to Online conversion errors |
| While opening your file in a newer QuickBooks year | A version upgrade or company file update | QuickBooks Desktop upgrade guide |
| While bringing data in from another accounting program | A data conversion job | QuickBooks data conversion service |
Users report these during a Migrator Tool move, and this page treats them as one problem:
Error dialog box reading Migrator Tool Failed Unexpectedly, with three other wordings users report from the same tool
When the tool works, it copies the QuickBooks install details, up to the last three company files opened on the old computer, templates and forms, letters, memorized and scheduled reports, local attachments, printer settings, and add-on data such as Loan Manager. It does not move a multi-user setup, payroll and payment sign-ins, company files not opened recently, manual backups, or Intuit Data Protect.
A successful run leaves your files on the old computer. Whether a failed run changes anything there is not confirmed, so until a fresh backup exists, treat the old computer as holding your only good copy: do not uninstall QuickBooks there, and do not delete, move or rename the company file.
Copy it word for word.
Note the computer and the stage: copying to the USB drive, after the password, during a download, or near the end.
If your case is not a Migrator Tool move: use the matching table row in this section, or send the details with the no-login form on this page.
This guide gives you a safe order of work for a failed Migrator Tool run: a backup before anything changes, quick checks of the conditions the tool needs, one careful retry, a stopping rule, a complete process to migrate your QuickBooks software and data files to a new PC when the automated tool fails, and the checks that confirm registration on the new computer.
| Your situation | First action | Section |
|---|---|---|
| You just saw the message | Back up on the old computer | How do you fix the error |
| You are not sure the tool supports your setup | Press F2, then read the Windows system type | Why did the tool fail |
| The tool has failed twice | Stop retrying | Move QuickBooks manually |
| QuickBooks runs on the new computer but asks to register | Open the Help menu | Check after the move |
| No license numbers, the backup fails, or payroll is due | Send the details | When to get help |
Does another computer open the same company file? If yes, send the details with the no-login form on this page before you start, because the tool does not copy a multi-user setup. If no, start at the first row that fits.
A documented cause is 64-bit QuickBooks files moved to a 32-bit Windows computer. The tool also needs US QuickBooks Desktop 2018 or newer used on one computer, the Admin user, an updated Windows 11 or later on the new computer, internet on the new computer, and enough free space. Each is a quick check.
Rules for the US edition, checked on October 20, 2026. They can change.
| Condition | How to check | If it is not met |
|---|---|---|
| 64-bit QuickBooks files go only to 64-bit Windows | Read the system type on the new computer | With 2022 or 2023 files, the tool can stop. Stop retrying the tool. Move to a 64-bit computer, or send the details if none is available. |
| US QuickBooks Desktop 2018 or newer | Press F2 on the old computer | Move QuickBooks manually. |
| Used on one computer | Ask whether any other computer opens the file | Send the details before you start. |
| Signed in as the Admin user | Check your sign-in name | Sign in as the Admin user, the main QuickBooks login that can set up users. |
| An updated Windows 11 or later on the new computer | Read the Windows version on the new computer | Update it. On Windows 10, move QuickBooks manually. |
| Internet on the new computer | Open any website on it | Connect it and keep it online for the whole run. |
| Enough free space | Compare the USB drive with the amount the tool shows; check both computers | Use a larger drive, or free space. |
| QuickBooks updated on the old computer | Press F2 and note the release | Install the updates. |
| License and product numbers at hand | Press F2 on the old computer | Find them before you retry. |
QuickBooks Desktop 2024 lists 64-bit Windows 11 and does not support 32-bit Windows. It still installs on Windows 10, but Microsoft ended Windows 10 support on October 14, 2025.
Some pages tell you to turn off security software, roll Windows back, reformat the USB drive, delete program folders, or export IIF files. These are not part of QuickBooks’ own move steps, and several can cost data or protection, so skip them. The move steps’ own security note is that Windows stops the batch file from starting by itself.
Open QuickBooks on the old computer and press F2 (or Ctrl + 1).
You see: the Product Information window with the product, the year, and the release.
If QuickBooks will not open on the old computer: stop and send the details with the no-login form on this page.
On Windows 11, open Settings, select System, then About, and read System type under Device specifications. On Windows 10, search for System Information, open it, and read System Type.
You see: whether Windows is 64-bit or 32-bit.
Windows Settings, System, About, with System type under Device specifications highlighted
Mark each condition in the table as met or not met.
If a condition cannot be met: for a 32-bit new computer, stop retrying the tool. Move to a 64-bit computer, or send the details if none is available. Any other unmet condition means the manual move section on this page.
If you encounter issues while resolving Migrator Tool failures, back up the company file on the old computer first, then confirm the tool’s conditions, update Windows on the new computer and QuickBooks on the old one, check space and internet, and run Move_QuickBooks.bat once more. If the same message returns, stop and move QuickBooks manually.
One rule runs through this section: two attempts, then stop and send the details with the no-login form on this page. The failed run was attempt one, so you have one retry left.
Leave the old computer as it is: uninstall nothing and do not move the company file. Sign in as the Admin user, the main QuickBooks login that can set up users. If another computer opens the same file, or a provider hosts your QuickBooks, stop and use the form.
Do this on the old computer, in QuickBooks, with the company file open.
Open the File menu and select Switch to Single-user Mode. If the menu offers Switch to Multi-user Mode instead, you are already in single-user mode. When you finish, if other people share this file, select File, Switch to Multi-user Mode.
Open File, hover over Back up Company, and select Create Local Backup.
Select Local Backup, then Next.
In the Local Backup Only section, select Browse. Pick a folder that is easy to find, for example one named QuickBooks Backup on the desktop (not on the tool’s USB drive), and select OK.
Select Save it now, then Next.
You see: a confirmation message, and a file ending in .qbb. Copy it to a second drive or cloud folder too, never the tool’s USB drive, which the tool clears when it finishes.
If the backup fails: try once more with a different folder. If it fails again, stop and use the form. Do not retry the tool without a backup.
On the old computer, press F2: you need a US edition, 2018 or newer.
On the new computer, read the Windows version and the system type: Settings, System, About, System type on Windows 11, or System Information, System Type on Windows 10.
If it reads 32-bit: stop retrying the tool. Move to a 64-bit computer, or send the details if none is available. If the version is older than 2018, or the new computer runs Windows 10: move QuickBooks manually instead.
Open Settings, select Windows Update, then Check for updates, and install what it offers.
Restart the new computer, then check for updates once more.
You see: no pending updates.
If an update fails twice: stop and use the form, or ask whoever manages that computer.
In QuickBooks, open Help, select Update QuickBooks Desktop, open the Update Now tab, and select Get Updates.
Close and reopen QuickBooks, and select Install Now when it asks. Press F2 and compare the release with the one you noted.
If the release did not change: download the update once more. If it still does not change, stop and use the form.
Use a USB drive with more free space than the amount the tool shows.
Free some space if the QuickBooks drive on either computer is nearly full.
Keep the new computer connected to the internet for the whole run.
Do this only if the message came during the download or install stage on the new computer.
On the new computer, download and open QuickBooks Tool Hub.
Select Installation Issues, then QuickBooks Install Diagnostic Tool. Let it finish, then restart the new computer.
Restart the old and the new computer. Close other programs on the new one.
Open File, hover over Utilities, and select Move QuickBooks to another computer. Select I’m Ready, create a new one-time password, and write it down. Choose the USB drive and wait for the copy to finish.
You see: the tool reports the space it needs, then copies the files.
Open the USB drive in File Explorer on the new computer. Windows security stops the tool starting by itself, so double-click Move_QuickBooks.bat.
If the file shows as Move_QuickBooks.exe, or with no .bat ending: do not rename it. Count this attempt as failed.
Type the one-time password exactly as you created it, then select Let’s go. The time depends on the computer, the internet speed, and the size of your files.
You see: QuickBooks opens on the new computer with your company file, and the tool’s files are gone from the USB drive. Next, open Help and select Activate QuickBooks Desktop, Activate QuickBooks or Register QuickBooks, whichever shows, then run the after-move checks.
If the same or another failure message appears: this was your second attempt, so stop using the tool. Move QuickBooks manually with your backup (the manual move section on this page), or call 1-802-778-9005.
When the Migrator Tool keeps failing, move QuickBooks manually: back up the company file on the old computer, install the same QuickBooks version on the new computer, register it with your license and product numbers, and restore the backup under a new name. Keep the old computer as it is until the new one opens your file.
This section is the outline for a failed tool. Every click of the manual move, step by step with illustrations, is in how to transfer QuickBooks to a new computer.
If QuickBooks will not open on the old computer: you cannot make the backup this outline needs. Stop and use the form, or follow the dead-computer section of the transfer guide linked in this section.
With the company file open: File, Switch to Single-user Mode, then File, Back up Company, Create Local Backup, Local Backup, Next, Browse, pick a folder such as QuickBooks Backup on the desktop, OK, Save it now, Next. Copy the .qbb file to a USB or external drive and keep the original. When you finish, if other people share this file, select File, Switch to Multi-user Mode.
If the backup fails twice: stop and use the form.
If QuickBooks already opens on the new computer after the failed run and F2 shows the same version as the old computer, skip to Step 3. Otherwise, on Intuit’s Downloads & Updates page choose your country, product, and version, select Search and Download, run the installer, and enter your license and product numbers.
If the install fails: in QuickBooks Tool Hub, select Installation Issues, then QuickBooks Install Diagnostic Tool, restart, and install once more. If it fails again, stop and use the form.
Open Help. If Activate QuickBooks Desktop, Activate QuickBooks or Register QuickBooks shows, select it (after Activate QuickBooks, select Begin Registration), and follow the prompts with the Intuit account that holds the license.
Copy the .qbb file to a folder on the new computer. Select File, Open or Restore Company, Restore a backup copy, Next, Local Backup, Next, pick the .qbb file, and save it under a name no other company file in that folder uses. Never restore over an existing file.
Restore on the new computer: File, Open or Restore Company, Restore a backup copy, Local Backup, then the backup saved under a new name
Install updates (Help, Update QuickBooks Desktop, Update Now, Get Updates), download the latest payroll tax table if you run payroll, and copy add-on files such as letters and Loan Manager data from the folder named Restored_ plus your company name and _Files.
You see: the restored file opens on the new computer with your latest work, and QuickBooks no longer asks to register.
If a step fails twice: stop and use the form, or call 1-802-778-9005. For a registration message, see the QuickBooks license errors guide. Do not uninstall anything on the old computer.
After moving QuickBooks to a new computer, confirm that the latest company file opens, register QuickBooks from the Help menu, and sign in again to payroll, banking and payment services, because the Migrator Tool does not move those sign-ins. Then set up Intuit Data Protect, make a fresh backup, and rename the old files last.
On the new computer, open the file, press F2, and read the location under File Information.
Confirm the last entries made on the old computer are there.
If entries are missing: it may be an older copy. Close it and send the details with the no-login form on this page before entering anything.
Open Help. If Activate QuickBooks Desktop, Activate QuickBooks or Register QuickBooks shows, select it (after Activate QuickBooks, select Begin Registration). QuickBooks must be registered again after a move to another computer.
If registration or a license message gets in the way: see the QuickBooks license errors guide or QuickBooks unable to sync license. If it fails twice, use the form.
In QuickBooks on the new computer, as the Admin user, with the company file open: File, Switch to Single-user Mode, then File, Back up Company, Create Local Backup, Local Backup, Next, Browse, pick a folder such as QuickBooks Backup on the desktop, OK, Save it now, Next. When you finish, if other people share this file, select File, Switch to Multi-user Mode.
You see: a confirmation message, and a file ending in .qbb.
Only after these checks pass: on the old computer, press F2, read the file location, and close QuickBooks. In File Explorer, right-click each company file you moved, select Rename, and add old to the end of the name. Never delete it. Uninstall QuickBooks on the old computer only when you no longer need it.
You see: the latest file opens on the new computer, QuickBooks no longer asks to register, your services are signed in, and a fresh backup exists.
If one check fails twice: stop and use the form.
Get help with a failed QuickBooks migration when the Migrator Tool fails twice, the manual restore or registration fails, you cannot find your license numbers, the new computer is 32-bit, or payroll or month-end work cannot wait. At these points another try risks data or time.
Note the exact message and stage, your QuickBooks version (F2), the new computer’s Windows version and system type, whether a backup exists, and whether you have your license and product numbers.
Get help finishing your QuickBooks move. Call 1-802-778-9005 or send the details with the no-login form on this page. Do not send passwords or license numbers in the first message. Support hours: Monday through Friday, 24 hours a day. Specialists use a secure, industry-standard remote desktop application to diagnose and work on the problem directly on your computer. Never share passwords during a remote session, and close the remote tool when the work is done.
Allow remote access only to a provider you contacted yourself. To reach Intuit instead, open Help in QuickBooks, select QuickBooks Desktop Help, then Contact Us. More help is on the contact QuickBooks Desktop support page.
Users ask these ten questions after the QuickBooks Migrator Tool stops with a migration failed unexpectedly message. Each answer ends with a narrowing question and what each reply means, so you can pick the next step for your setup. If your case does not fit, send the details with the no-login form on this page.
A successful run leaves your files on the old computer. Do not assume the same after a failed run: check before you trust it. Open the company file on the old computer, look at your most recent transactions, and make a fresh backup to a drive that is not the tool’s USB drive.
To narrow it down: does the file open on the old computer with your latest entries? If yes, back up now and continue with the fix steps. If no, stop, do not retry the tool, and send the details with the form.
Treat it as the same Migrator Tool failure. Users report this wording near the end of a move to a new Windows 11 computer, including on Enterprise. Check the 64-bit rule and updates, then use your one retry. If it returns, move QuickBooks manually from your backup.
Before you retry: does QuickBooks already open on the new computer? If yes, press F2 there and check for your company file before running the tool again. If no, run the checks and the one retry.
Users report this message on the new computer right after typing the one-time password. Retype it once, with the same capital letters, and confirm the new computer is online. If the message returns, count that attempt as failed and follow the stopping rule.
Your answer decides the next step: are you sure of the password you created? If yes, check the internet connection and retry once. If no, start the tool again on the old computer and create a new password you write down.
Not for QuickBooks Desktop 2024, which lists 64-bit Windows 11 and does not support 32-bit Windows. 64-bit QuickBooks files also move only between 64-bit systems. With 2022 or 2023 files, the Migrator Tool can stop on a 32-bit computer. Check the system type before buying anything.
To narrow it down: is a 64-bit computer available? If yes, stop retrying the tool and move to that computer. If no, send the details with your QuickBooks version before you buy hardware.
Yes, keep it at hand. The tool can download, install and activate QuickBooks by itself when it works. If it fails twice, the manual move needs your license and product numbers. You also need them if registration asks for them on the new computer.
Before you retry: can you open Product Information with F2 on the old computer? If yes, write both numbers down now. If no, check your purchase email and Intuit account, and send the details if neither shows them.
Yes, for a US Enterprise 2018 or newer used on one computer, though you can also reach out for specialized assistance with Enterprise editions if you encounter issues during setup. When migrating, the tool also preserves custom configurations and copies Enterprise advanced reports, though setup requirements can vary depending on your specific edition. It does not copy a multi-user setup, so check whether other computers open your file before you rely on the tool or its retry.
To narrow it down: does any other computer open the same company file? If yes, send the details before you move anything, because the network setup is redone by hand. If no, the fix steps on this page apply.
The move steps are written for another computer, but users report the same failure between two drives in one computer. In one older Windows 10 case, the fix was to update Windows and run the tool once more, then reinstall QuickBooks and restore a backup. The backup-first rule applies.
Before you start: is the old drive still in the computer and readable? If yes, back up the company file from it first, then follow the fix steps. If no, stop and send the details before anyone formats or removes a drive.
Users report this on new Windows 10 and Windows 11 computers. The tool never starts by itself, and updating Windows is the documented step when it will not open. Update Windows on the new computer, restart, and double-click the file once more. That counts as your retry, so a second silent failure means the manual move.
To narrow it down: does the file name end in .bat? If yes, update Windows and double-click it once more. If no, do not rename it; start the tool again on the old computer to create the drive afresh. This counts as your retry.
QuickBooks keeps its log as QBWin.log under %localappdata%\Intuit\QuickBooks\log, in a folder for each version. No separate Migrator Tool log is documented, so treat pages that cite a Migration.log file with care. The exact on-screen message and the stage it stopped at are what support needs first.
Before you search for logs: has a support agent asked you for a log? If yes, send QBWin.log from that folder on the computer that showed the message. If no, send the exact message and the stage instead.
Yes. In QuickBooks, open Help, select QuickBooks Desktop Help, then Contact Us to reach Intuit support. Some versions offer Send Feedback Online under Help, with a Bug Report option that was suggested for Migrator Tool problems in the past. A report does not move your data, so keep your backup and follow the stopping rule.
Your answer decides the next step: do you need QuickBooks working on the new computer today? If yes, move it manually from your backup now and report the failure afterward. If no, report it first and keep the old computer as it is.