Skip to content

How To Use

Jeffrey edited this page Oct 6, 2025 · 33 revisions

Launching the script

Warning

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.

Quick method

Download & run the script automatically via PowerShell. When using this method, any files will be downloaded to %temp%/Win11Debloat. These files will be automatically cleaned up once the script is done.

  1. Open PowerShell or Terminal, preferably as an administrator.
  2. Copy and paste the command below into PowerShell:
& ([scriptblock]::Create((irm "https://debloat.raphi.re/")))
  1. Wait for the script to automatically download Win11Debloat.
  2. Carefully read through and follow the on-screen instructions.

This method supports command-line parameters to customize the behaviour of the script. Please click here for more information.

Traditional method

Manually download & run the script.

  1. Download the latest version of the script, and extract the .ZIP file to your desired location.
  2. Navigate to the Win11Debloat folder
  3. Double click the Run.bat file to start the script. NOTE: If the console window immediately closes and nothing happens, try the advanced method below.
  4. Accept the Windows UAC prompt to run the script as administrator, this is required for the script to function.
  5. Carefully read through and follow the on-screen instructions.

Advanced method

Manually download the script & run the script via PowerShell. Recommended for advanced users.

  1. Download the latest version of the script, and extract the .ZIP file to your desired location.
  2. Open PowerShell or Terminal as an administrator.
  3. Temporarily enable PowerShell execution by entering the following command:
  Set-ExecutionPolicy Unrestricted -Scope Process -Force
  1. In PowerShell, navigate to the directory where the files were extracted. Example: cd c:\Win11Debloat
  2. Now run the script by entering the following command:
  .\Win11Debloat.ps1
  1. Carefully read through and follow the on-screen instructions.

This method supports command-line parameters to customize the behaviour of the script. Please click here for more information.

Usage

After launching the script you will be presented with a menu where you have a couple of options. To continue, simply enter the number of the desired option and hit enter.

image

(1) Default Mode

Win11Debloat's default mode allows you to quickly and easily apply the changes that are recommended for most people. This includes removing many annoying distractions, disabling telemetry and tracking and optionally uninstalling the default or your custom selection of apps. Please refer to this page a full run-down of all changes that are included as part of the default mode.

(2) Custom Mode

In the Custom Mode you have more control over what changes the script makes to your system. It is recommended that you carefully read through all the options here to prevent disabling features and removing apps that you may actually want to use. In case you do accidentally disable something that you want to re-enable, don't worry! We have a full guide here on how to revert changes made by the script.

Win11Debloat will automatically remember the settings you selected in Custom Mode, allowing you to quickly re-apply them whenever you run the script in the future. The last used settings are saved to the SavedSettings file in the root folder of the script. If you used the Quick Method to launch the script, this can be found in %temp%/Win11Debloat.

(3) App Removal Mode

If you're only interested in quickly removing pre-installed applications you can use the App Removal Mode. After selecting this mode you'll be greeted with an interface where you can select all the apps that you wish to uninstall. Apps that Win11Debloat considers bloatware will be selected by default. You can find more information about app removal here.

image

Win11Debloat will automatically remember your app selection, so you can quickly uninstall unwanted apps again. The custom apps selection is saved to the CustomAppsList file, found in the root folder of the script. If you used the Quick Method to launch the script, this can be found in %temp%/Win11Debloat.

(4) Apply Saved Custom Settings

This option is only shown if you've previously run the script in Custom Mode or the App Removal Mode. It allows you to quickly apply the custom settings that you used last time. As explained above, your last used custom settings and app selection are saved to the SavedSettings and CustomAppsList files respectively, which are saved to the root folder of the script. If you used the Quick Method to launch the script, these can be found in %temp%/Win11Debloat.

Parameters

Both the quick and advanced launch methods support command-line parameters, these allow you to customize the behaviour of Win11Debloat to meet your needs. To use parameters, simply launch the script as you normally would, but add the parameters you want to use at the end with spaces in between.

For instance, you can run the script with the -RunDefaults and -Silent parameters to quickly apply the default settings of the script and skip all interactive prompts. Example:

& ([scriptblock]::Create((irm "https://debloat.raphi.re/"))) -RunDefaults -Silent

A table of all the supported parameters and what they do can be found below.

Parameter Description
-CreateRestorePoint Create a system restore point before making any changes. Unless a restore point was already created in the last 24 hours.
-Silent Suppresses all interactive prompts, so the script will run without requiring any user input.
-Sysprep Run the script in Sysprep mode. All changes will be applied to the Windows default user profile and will only affect new user accounts. Click here for more details.
-LogPath <PATH> Change in what folder the script will save the log file. The log will be saved to the root folder of the script if no path is specified, or if the specified path doesn't exist.
-User <USERNAME> Run the script for the specified user, instead of the currently logged in user. This user must have logged on at least once, and cannot be logged in at the time the script is run. Click here for more details.
-RunDefaults Run the script with the default settings, including removing the default selection of apps.
-RunDefaultsLite Run the script with the default settings, but without removing any apps.
-RunSavedSettings Run the script with the saved custom settings from last time. These settings are saved to and read from the SavedSettings file in the root folder of the script.
-RemoveApps Remove the default selection of bloatware apps.
-RemoveAppsCustom Remove all apps specified in the CustomAppsList file. No apps will be removed if this file does not exist. IMPORTANT: You can generate your custom apps list by running the script with the -RunAppsListGenerator parameter as explained here.
-RunAppsListGenerator Run the apps list generator to generate a custom list of apps to remove, the list is saved to the CustomAppsList file inside the root folder of the script. Running the script with the -RemoveAppsCustom parameter will remove the selected apps.
-RemoveHPApps Remove preinstalled HP apps. Click here for a full list.
-RemoveCommApps Remove the Mail, Calendar, and People apps.
-RemoveW11Outlook Remove the new Outlook for Windows app.
-RemoveGamingApps Remove the Xbox App and Xbox Gamebar.
-ForceRemoveEdge Forcefully remove Microsoft Edge, this option leaves Core, WebView and Update components installed for compatibility. NOT RECOMMENDED!
-DisableDVR Disable Xbox game/screen recording feature & stop gaming overlay popups.
-ClearStart Remove all pinned apps from start for the current user. (Windows 11 update 22H2 or later only)
-ClearStartAllUsers Remove all pinned apps from start for all existing and new users. (Windows 11 update 22H2 or later only)
-ReplaceStart <PATH> Replace the pinned apps from start for the current user with your template file. Click here for more details. (Windows 11 update 22H2 or later only)
-ReplaceStartAllUsers <PATH> Replace the pinned apps from start for all existing and new users with your template file. Click here for more details. (Windows 11 update 22H2 or later only)
-DisableStartRecommended Disable & hide the recommended section in the start menu. This will also change the start menu layout to More pins.
-DisableStartPhoneLink Disable the Phone Link mobile devices integration in the start menu. This will not uninstall or disable Phone Link itself.
-DisableTelemetry Disable telemetry, diagnostic data & targeted ads.
-DisableSuggestions Disable tips, tricks, suggestions and ads in start, settings, notifications and File Explorer.
-DisableEdgeAds Disable ads and the MSN news feed in Microsoft Edge.
-DisableDesktopSpotlight Disable the Windows Spotlight desktop background option.
-DisableLockscreenTips Disable tips & tricks on the lockscreen.
-DisableSettings365Ads Disable Microsoft 365 ads in Settings Home.
-DisableSettingsHome Hide the Settings Home page completely. Settings will open to the System tab instead.
-DisableBing Disable & remove Bing web search, Bing AI & Cortana in Windows search.
-DisableCopilot Disable and remove Microsoft Copilot. (Windows 11 only)
-DisableRecall Disable Windows Recall, an AI snapshot history tool for Copilot+ PC's. (Windows 11 only)
-DisableClickToDo Disable Click to Do, an AI text & image analysis tool for Copilot+ PC's. (Windows 11 only)
-DisableEdgeAI Disable AI features in Edge. (Windows 11 only)
-DisablePaintAI Disable AI features in Paint. (Windows 11 only)
-DisableNotepadAI Disable AI features in Notepad. (Windows 11 only)
-RevertContextMenu Restore the old Windows 10 style context menu. (Windows 11 only)
-DisableMouseAcceleration Turn off Enhance Pointer Precision, also known as mouse acceleration. Requires reboot to apply.
-DisableStickyKeys Disable the Sticky Keys keyboard shortcut.
-DisableFastStartup Disables Fast Start-up to ensure a full shutdown.
-DisableModernStandbyNetworking
Disable network connectivity during Modern Standby to reduce battery drain during sleep. (Windows 11 only)
-ShowHiddenFolders Show hidden files, folders and drives.
-ShowKnownFileExt Show file extensions for known file types.
-HideDupliDrive Hide duplicate removable drive entries from the File Explorer navigation pane, so only the entry under This PC remains.
-EnableDarkMode Enable dark mode for system and apps.
-DisableTransparency Disable transparency effects.
-DisableAnimations Disable animations and visual effects.
-TaskbarAlignLeft Align taskbar icons to the left. (Windows 11 only)
-CombineTaskbarAlways Set the taskbar on the main monitor to always combine buttons and hide labels. (Windows 11 only)
-CombineTaskbarWhenFull Set the taskbar on the main monitor to only combine buttons and hide labels when the taskbar is full. (Windows 11 only)
-CombineTaskbarNever Set the taskbar on the main monitor to never combine buttons and always show labels. (Windows 11 only)
-CombineMMTaskbarAlways Set the taskbar on secondary monitors to always combine buttons and hide labels. (Windows 11 only)
-CombineMMTaskbarWhenFull Set the taskbar on secondary monitors to only combine buttons and hide labels when the taskbar is full. (Windows 11 only)
-CombineMMTaskbarNever Set the taskbar on secondary monitors to never combine buttons and always show labels. (Windows 11 only)
-MMTaskbarModeAll Set the taskbar to show app icons on all taskbars. (Windows 11 only)
-MMTaskbarModeMainActive Set the taskbar to show app icons on main taskbar and on taskbar where the windows is open. (Windows 11 only)
-MMTaskbarModeActive Set the taskbar to only show app icons on taskbar where the window is open. (Windows 11 only)
-HideSearchTb Hide search icon from the taskbar. (Windows 11 only)
-ShowSearchIconTb Show search icon on the taskbar. (Windows 11 only)
-ShowSearchLabelTb Show search icon with label on the taskbar. (Windows 11 only)
-ShowSearchBoxTb Show search box on the taskbar. (Windows 11 only)
-HideTaskview Hide the taskview button from the taskbar. (Windows 11 only)
-HideChat Hide the chat (meet now) icon from the taskbar.
-DisableWidgets Disable the widget service, which disables widgets on the taskbar and lockscreen. This will also remove the StartExperiencesApp, which is responsible for My feed in the Widgets panel.
-EnableEndTask Enable the End Task option in the taskbar right click menu.
-EnableLastActiveClick Enable the 'Last Active Click' behavior in the taskbar app area. This allows you to repeatedly click on an application's icon in the taskbar to switch focus between the open windows of that application.
-HideHome Hide the home section from the File Explorer navigation pane and add a toggle in the File Explorer folder options. (Windows 11 only)
-HideGallery Hide the gallery section from the File Explorer navigation pane and add a toggle in the File Explorer folder options. (Windows 11 only)
-ExplorerToHome Change File Explorer to open to Home.
-ExplorerToThisPC Change File Explorer to open to This PC.
-ExplorerToDownloads Change File Explorer to open to Downloads.
-ExplorerToOneDrive Change File Explorer to open to OneDrive.
-HideOnedrive Hide the OneDrive folder from the File Explorer navigation pane. (Windows 10 only)
-Hide3dObjects Hide the 3D objects folder under This pc in File Explorer. (Windows 10 only)
-HideMusic Hide the music folder under This pc in File Explorer. (Windows 10 only)
-HideIncludeInLibrary Hide the Include in library option in the context menu. (Windows 10 only)
-HideGiveAccessTo Hide the Give access to option in the context menu. (Windows 10 only)
-HideShare Hide the Share option in the context menu. (Windows 10 only)
Clone this wiki locally