Skip to main content

How to Hide or Show Desktop Icons from a Batch Script

A clean desktop with zero icons is often required for kiosk machines, digital signage, presentation laptops, or specialized workstations. While users can right-click the desktop, select "View," and uncheck "Show desktop icons," automating this process via a Batch Script is essential for deployment scenarios or custom focus-mode utilities.

In this guide, we will explore the registry keys that control desktop icon visibility and how to toggle them programmatically, ending with a script to apply the changes without restarting the entire system.

The Registry Key for Desktop Icons​

The visibility of desktop icons is controlled by a single DWORD value in the Windows Registry:

HKCU\Software\Microsoft\Windows\CurrentVersion\Explorer\Advanced
Value Name: HideIcons
Type: REG_DWORD
  • 0 = Icons are Visible (Show desktop icons is checked).
  • 1 = Icons are Hidden (Show desktop icons is unchecked).

This key dictates the state of the "Show desktop icons" context menu option. Modifying it directly from Batch is straightforward.

Method 1: Toggling via the Registry and Restarting Explorer​

The simplest approach is to use the REG ADD command to flip the HideIcons value. However, changes to Explorer\Advanced are only evaluated when the Windows Shell launches. Therefore, we must restart explorer.exe to see the change.

Hiding Desktop Icons​

@echo off
setlocal

echo Hiding Desktop Icons...

:: Set HideIcons to 1
REG ADD "HKCU\Software\Microsoft\Windows\CurrentVersion\Explorer\Advanced" /v HideIcons /t REG_DWORD /d 1 /f >nul

:: Restart Explorer to apply visually
taskkill /f /im explorer.exe >nul 2>&1
timeout /t 1 /nobreak >nul
start explorer.exe

echo [OK] Desktop icons hidden.
pause

Showing Desktop Icons​

@echo off
setlocal

echo Showing Desktop Icons...

:: Set HideIcons to 0
REG ADD "HKCU\Software\Microsoft\Windows\CurrentVersion\Explorer\Advanced" /v HideIcons /t REG_DWORD /d 0 /f >nul

:: Restart Explorer to apply visually
taskkill /f /im explorer.exe >nul 2>&1
timeout /t 1 /nobreak >nul
start explorer.exe

echo [OK] Desktop icons restored.
pause

Method 2: The Seamless API Approach (No Explorer Restart)​

Restarting Explorer is disruptive. It closes open folders and makes the taskbar flash. A much cleaner, professional approach is to modify the registry key and then send an API message to the Windows Shell, telling it to redraw the desktop immediately, exactly as it does when you click "Refresh" (F5).

Because Batch cannot call Windows APIs natively, we embed a tiny PowerShell script to execute the SHChangeNotify function.

Interactive Toggle Script (Seamless)​

@echo off
title Desktop Icon Manager
setlocal enabledelayedexpansion

set "reg_path=HKCU\Software\Microsoft\Windows\CurrentVersion\Explorer\Advanced"

:menu
cls
color 0F
echo =============================================
echo        DESKTOP ICON MANAGER
echo =============================================
echo.
echo [1] Hide Desktop Icons
echo [2] Show Desktop Icons
echo [3] Exit
echo.
set "opt="
set /p "opt=Select: "

if "!opt!"=="1" (
    REG ADD "!reg_path!" /v HideIcons /t REG_DWORD /d 1 /f >nul
    goto refresh
)
if "!opt!"=="2" (
    REG ADD "!reg_path!" /v HideIcons /t REG_DWORD /d 0 /f >nul
    goto refresh
)
if "!opt!"=="3" exit /b
goto menu

:refresh
echo.
echo Applying changes seamlessly...

:: Fixed: Single-line PowerShell to avoid CMD ^ escaping issues
powershell -noprofile -command "Add-Type -Name 'ShellRefresh' -Namespace 'Win32' -MemberDefinition '[DllImport(\"shell32.dll\")] public static extern void SHChangeNotify(int wEventId, int uFlags, IntPtr dwItem1, IntPtr dwItem2);'; [Win32.ShellRefresh]::SHChangeNotify(0x8000000, 0, [IntPtr]::Zero, [IntPtr]::Zero)"

if !errorlevel! equ 0 (
    echo [OK] Desktop refreshed.
) else (
    echo [ERROR] Failed to refresh. You may need to press F5 on the desktop.
)
pause
goto menu

How the Seamless Script Works​

  1. Modify Registry: The script first uses REG ADD to flip the HideIcons DWORD to 1 (hide) or 0 (show).
  2. SHChangeNotify: It then uses PowerShell to dynamically compile a C# snippet that hooks into shell32.dll. The 0x8000000 (SHCNE_ALLEVENTS) flag tells Windows that a global setting has changed and all Explorer windows (including the Desktop background) must re-evaluate their state.
  3. Result: The icons vanish or reappear instantly, and no applications or folders are closed.

Common Mistakes​

The Wrong Way: Expecting Immediate Results from REG ADD alone​

:: WRONG - The registry changes, but the screen does not update
REG ADD "HKCU\Software\Microsoft\Windows\CurrentVersion\Explorer\Advanced" /v HideIcons /t REG_DWORD /d 1 /f
echo Done.

Output Concern: If you execute this code and look at the desktop, the icons will still be there. If you right-click the desktop, the "Show desktop icons" checkmark will be out of sync with reality. The registry change is useless without the subsequent Shell refresh or Explorer restart.

The Correct Way: Always Pair with a Refresh​

Whether you use taskkill or the PowerShell API method, you must notify Explorer that the registry value changed.

Alternative: Third-Party Utility (NirCmd)​

For environments that allow external utilities, NirCmd provides a built-in command specifically for hiding desktop icons without touching the registry.

@echo off
:: Use NirCmd to hide the icons
nircmd.exe win hide class Progman

:: Later in the script, restore them
nircmd.exe win show class Progman
pause
warning

Hiding the Progman class hides the entire desktop layer, including wallpaper interactions on older Windows versions. Modifying the HideIcons registry key is the officially supported Microsoft method for achieving this effect.

Best Practices​

  1. Use the embedded PowerShell API method: This provides the smoothest user experience and avoids disrupting the system with aggressive taskkill commands.
  2. Combine tasks: If your Batch script makes other changes that require an Explorer restart (like adding items to the Startup folder or manipulating standard shell DLLs), you can bundle the registry toggle into that sequence rather than firing a special refresh.

Conclusion​

Hiding or showing desktop icons from a Batch Script involves modifying the HideIcons registry value within the current user's Explorer settings. While changing the registry is trivial via the REG ADD command, the real challenge lies in forcing the Windows Shell to re-read that setting instantly. By utilizing an embedded PowerShell snippet to call the SHChangeNotify API, you can seamlessly toggle desktop icons on and off, creating professional utility scripts for focus modes or presentation environments.

Table of Contents