Skip to content

How To Use

Jeffrey edited this page Jun 26, 2025 · 8 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 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 parameters to customize the behaviour of the script. Please click here for more information.

Parameters

Both the quick and advanced launch methods support parameters, which 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. 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 atleast 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.
-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.
-RemoveDevApps Remove developer-related apps such as Remote Desktop, DevHome and Power Automate.
-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.
-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 snapshots. (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.
-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)
-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 & hide the widget (news and interests) icon from the taskbar. 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.
-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