Win11Debloat
CLI ToolRaphire/Win11Debloat
A simple PowerShell script to remove pre-installed apps and disable telemetry on Windows.
Overview
Win11Debloat is a lightweight PowerShell script that removes pre-installed apps, disables telemetry and intrusive UI elements, and customizes Windows settings. It supports both interactive and command-line modes, and works on Windows 10 and 11. All changes can be easily reverted.
README Preview
# Win11Debloat\n\n[](https://github.com/Raphire/Win11Debloat/releases/latest)\n[](https://github.com/Raphire/Win11Debloat/discussions)\n[](https://github.com/Raphire/Win11Debloat/wiki/)\n\n Win11Debloat is a lightweight, easy to use PowerShell script that allows you to quickly declutter and customize your Windows experience, no installation required! You can use it to remove pre-installed apps, disable telemetry, remove intrusive interface elements and much more. No need to painstakingly go through all the settings yourself or remove apps one by one. Win11Debloat makes the process quick and easy!\n\nThe script also includes many features that system administrators and power users will enjoy. Such as a powerful command-line interface, support for Windows Audit mode and the ability to make changes to other Windows users. Please refer to our [wiki](https://github.com/Raphire/Win11Debloat/wiki/) for more details.\n\n\n\n#### Did this script help you? Please consider buying me a cup of coffee to support my work\n\n[](https://ko-fi.com/M4M5C6UPC)\n\n## Usage\n\n> [!Warning]\n> Great care went into making sure this script does not unintentionally break any OS functionality, but use at your own risk! If you run into any issues, please report them [here](https://github.com/Raphire/Win11Debloat/issues).\n\n### Quick method\n\nDownload & run the script automatically via PowerShell.\n\n1. Open PowerShell or Terminal, preferably as an administrator.\n2. Copy and paste the command below into PowerShell:\n\n```PowerShell\n& ([scriptblock]::Create((irm "https://debloat.raphi.re/")))\n```\n\n3. Wait for the script to automatically download Win11Debloat.\n4. Carefully read through and follow the on-screen instructions.\n\nThis method supports command-line parameters to customize the behaviour of the script. Please click [here](https://github.com/Raphire/Win11Debloat/wiki/Command%E2%80%90line-Interface#parameters) for more information.\n\n### Traditional method\n\n\n Manually downloa
FAQ (3)
TroubleshootingHow to fix the Microsoft.PowerShell.Security Get-Acl error when applying changes on Windows 11?
As a workaround, select Default mode, click Back, deselect the "Disable Microsoft Store app suggestions in search" option, click Next, and apply the changes. The script should then complete. The issue was addressed by adding error handling for Get-Acl in Set-StoreSearchSuggestionsDisabled, so updating the script to the latest version is the permanent fix.
TroubleshootingHow to fix "Unknown feature 'DisableSearchHighlights' could not be applied" in Win11Debloat?
-DisableSearchHistory and -DisableSearchHighlights were deprecated after their entries were removed from Config/Features.json, then fully removed from Win11Debloat. Update to the latest version and remove both switches from your command, for example: ./Win11Debloat.ps1 without -DisableSearchHistory or -DisableSearchHighlights. On older versions, the warning means the switch is accepted but the feature is not applied and is counted as a failed change; the switches can be safely omitted. The old .reg files are unsupported and should not be relied upon.
TroubleshootingWhy do pinned or unpinned Quick Access folders not update immediately after hiding Home in File Explorer?
This is a Windows side effect: Quick Access is tightly integrated with the Home node, so hiding Home can prevent File Explorer from refreshing pinned items in real time. There is no permanent fix from the debloat script. Workarounds: 1) Disable the "Hide 'Home' from navigation pane" option and reapply the script, or 2) restart Explorer after pinning/unpinning by running: taskkill /f /im explorer.exe; start explorer.exe. The change appears only after Explorer restarts while Home remains hidden.