sodcalculator

10 Tech How-To

Fix Windows Update Error: Upgrade Was Not Successful

Guide 10-37911 · Updated · Step by step

If you see the “Upgrade was not successful” error during a Windows feature update, the fix is to run the Windows Update Troubleshooter, then use the Update Assistant or Media Creation Tool to retry the installation. This error usually means the update files are corrupted or a background service is blocking the upgrade, not that your PC is broken. Below is a step-by-step guide to resolve it, plus what to do if the first attempt fails.

What Causes the “Upgrade Was Not Successful” Error?

This error appears when Windows 10 or Windows 11 cannot complete a feature update (like upgrading from version 22H2 to 23H2). The most common triggers are:

  • Corrupted update cache files in the SoftwareDistribution folder.
  • Third-party antivirus or security software interfering with the installation.
  • Insufficient disk space (Windows needs about 20 GB free for a feature update).
  • Outdated or incompatible drivers, especially graphics and network drivers.
  • Background services like Windows Update or BITS (Background Intelligent Transfer Service) not running.
  • System file corruption from a previous failed update.

Knowing the cause helps you choose the right fix, but most users can resolve it with the steps below in order.

Before You Start: Check Disk Space and Backup

First, make sure your PC has at least 20 GB of free space on the system drive (usually C:). If you’re low, use Disk Cleanup to remove temporary files. Also, back up important files to an external drive or cloud storage—feature updates rarely delete personal files, but it’s always safer to have a copy.

If you have a third-party antivirus, temporarily disable it (real-time protection) during the upgrade. Windows Defender will still protect you, and you can re-enable it after the update finishes.

Run the Windows Update Troubleshooter

Windows includes a built-in troubleshooter that automatically detects and fixes common update problems. Here’s how to run it:

  1. Open Settings (Win + I) and go to System > Troubleshoot > Other troubleshooters.
  2. Find Windows Update and click Run.
  3. Wait for it to complete—it may take a few minutes. If it finds issues, it will say “Apply this fix” and you can click that.
  4. Restart your PC and try the update again.

If the troubleshooter finds nothing, move to the next step.

Clear the Windows Update Cache

Corrupted downloaded update files are a frequent cause. To clear them, stop the Windows Update services, delete the cache, and restart the services. Do this in an admin Command Prompt:

  1. Press Win + X and select Terminal (Admin) or Command Prompt (Admin).
  2. Type the following commands, pressing Enter after each:
    net stop wuauserv
    net stop bits
  3. Open File Explorer and delete the contents of C:\Windows\SoftwareDistribution\Download (you can select all and delete).
  4. Restart the services:
    net start wuauserv
    net start bits
  5. Close the window and try the update again.

If you get an “Access denied” error, make sure you are running the command prompt as administrator.

Use the Windows Update Assistant or Media Creation Tool

If Windows Update still fails, download the Windows Update Assistant from Microsoft’s official website. It forces the feature update and often bypasses the error. Alternatively, use the Media Creation Tool:

  1. Download the Media Creation Tool from Microsoft.
  2. Run it and select Upgrade this PC now.
  3. Follow the prompts—it will download the latest version and install it, keeping your files and apps.

This method is more reliable because it downloads a fresh copy of the update, avoiding corrupted cache files. It can take an hour or more, so ensure your laptop is plugged in.

Run System File Checker and DISM

System file corruption can block updates. Run two built-in tools to repair them:

  1. Open an admin Command Prompt or Terminal.
  2. Type sfc /scannow and press Enter. It will scan and repair system files. This can take 15-30 minutes.
  3. After it finishes, run DISM /Online /Cleanup-Image /RestoreHealth and press Enter. This fixes the Windows image itself.
  4. Restart your PC and try the update again.

If SFC finds errors it cannot fix, DISM usually resolves them. Run SFC again after DISM to confirm.

What If Nothing Works? Try a Clean Install

If you’ve tried all the above and the error persists, a clean install of Windows is the most reliable fallback. This will remove all apps and files, so back up everything first. Use the Media Creation Tool to create a USB drive, then boot from it and select Install now. Choose “Custom” and delete the existing partitions (or just the main one) and install on the unallocated space. This gives you a fresh, updated system that will not have the upgrade error.

Before doing that, check if your PC meets the minimum requirements for the new version (especially for Windows 11, which requires TPM 2.0 and a supported CPU). If it doesn’t, the upgrade will never succeed, and you should stay on your current version.

Frequently Asked Questions

Will I lose my files if I use the Update Assistant?

No, the Update Assistant and Media Creation Tool’s “Upgrade this PC” option keep your personal files, settings, and installed apps. However, it’s still wise to back up before any major update.

How long does the “Upgrade was not successful” error take to fix?

It depends on the cause. Running the troubleshooter and clearing the cache takes about 10 minutes. Using the Update Assistant takes 1-2 hours, including download and install. A clean install takes about 30-60 minutes plus reinstallation of apps.

Can I skip the upgrade and stay on my current version?

Yes, you can. Microsoft supports each version for a certain period (usually 18 months for Home editions). You’ll still receive security updates, but you won’t get new features. Eventually, you’ll need to upgrade to stay supported.

Why does the error happen even with enough disk space?

Disk space is just one factor. Corrupted system files, incompatible drivers, or third-party software can all cause the error. The steps above address those other causes.

Is it safe to delete the SoftwareDistribution folder?

Yes, it’s safe. Windows will recreate it automatically. You’re only deleting downloaded update files, not system files.

What if my PC is very old and doesn’t meet Windows 11 requirements?

If you’re trying to upgrade to Windows 11 and your PC lacks TPM 2.0 or a supported CPU, the upgrade will fail. You can continue using Windows 10, which is supported until October 2025, or consider a new PC.

Related

General steps for current mainstream versions; menus can differ by device and version. See the disclaimer or report an error.

More in this bed

The whole Tech How-To bed →