Skip to main content

How to Add a New Registry Key in Batch Script

The Windows Registry is a central, hierarchical database that stores low-level settings for the operating system and for applications. Being able to programmatically add new keys is a critical skill for system administrators and power users. Scripts may need to create a new key to pre-configure a piece of software, to store custom script settings, or to enable a specific Windows feature. The standard, built-in command-line tool for all registry manipulations is REG.EXE.

This guide will teach you how to use the REG ADD command to safely and effectively create new registry keys. You will learn the simple syntax, the importance of administrator privileges, and see a practical example of how to create a key to store your own application's settings.

CRITICAL: Understanding the Risks of Modifying the Registry​

The registry is a critical component of the Windows operating system. An incorrect change can cause system instability, application failures, or even prevent Windows from booting.

  • Always have a backup or a system restore point before making significant changes.
  • Double-check your key paths. Deleting or modifying the wrong key can have serious consequences.
  • Only modify keys when you know exactly what the change will do.

Proceed with caution. You are solely responsible for any changes you make to your system's registry.

The Core Command: REG ADD​

The REG.EXE utility's ADD command is used to add new keys or to add/update values within existing keys. This guide focuses only on adding new keys.

Syntax: REG ADD <KeyName> [/f]

  • <KeyName>: The full path to the new registry key you want to create (e.g., HKCU\Software\MyNewApp).
  • /f: An optional switch to force the operation without prompting for confirmation if the key already exists. This is highly recommended for scripts.

Basic Example: Creating a Simple Registry Key​

This script creates a new key for a custom application under HKEY_CURRENT_USER, which is the correct location for user-specific settings.

@ECHO OFF
SET "NewKey=HKCU\Software\MyCustomApp"

ECHO --- Adding a New Registry Key ---
ECHO Key to create: "%NewKey%"
ECHO.

REG ADD "%NewKey%" /f

IF %ERRORLEVEL% EQU 0 (
    ECHO [SUCCESS] The registry key was created successfully.
) ELSE (
    ECHO [FAILURE] The command failed.
)

After running this, you can open regedit.exe and navigate to HKEY_CURRENT_USER\Software to see your new MyCustomApp key.

Adding a Key with a Default Value​

A registry key can have a "(Default)" value. You can set this value at the same time you create the key by using the /ve and /d parameters.

This creates a new key and sets its default value to "Enabled".

@ECHO OFF
SET "NewKey=HKCU\Software\MyCustomApp\Settings"

ECHO --- Creating Key with a Default Value ---

REM /ve: Sets the (Default) Value of the Empty key.
REM /d:  The Data for the value.
REG ADD "%NewKey%" /ve /d "Enabled" /f

ECHO.
ECHO --- Command sent ---

In regedit, you will now see the Settings key, and its (Default) value will be "Enabled" instead of "(value not set)".

How the Command REG ADD Works​

The REG ADD command is a direct interface to the Windows Registry API. When you execute it, it calls the underlying system functions to create a new key (or "subkey") in the specified location in the registry hive file. If any of the parent keys in the path do not exist, REG ADD will create them automatically. This is a very convenient feature, similar to MKDIR.

For example, REG ADD "HKCU\A\B\C" will create A, then B, then C if none of them exist.

Common Pitfalls and How to Solve Them​

Problem: "Access is denied." (Administrator Privileges)​

This is the most common error. The ability to write to the registry is a privileged operation, especially for system-wide keys.

  • HKEY_CURRENT_USER (HKCU): You can typically write to most locations under this hive as a standard user.
  • HKEY_LOCAL_MACHINE (HKLM): You must have administrator rights to write to this hive.

Solution: For any script that modifies HKEY_LOCAL_MACHINE, it must be run as an Administrator.

Problem: The Key Path Contains Spaces​

If your key name contains spaces, you must enclose the entire key path in double quotes.

Exmaple of error:

REM This will FAIL.
REG ADD HKCU\Software\My Cool App

Solution: Always Quote Your Key Paths​

REM This is the correct, safe syntax.
REG ADD "HKCU\Software\My Cool App"

Problem: The Key Already Exists​

If you run REG ADD without the /f switch and the key already exists, the command will prompt you for confirmation.

Value <KeyName> exists, overwrite? (Yes/No)

This will halt any unattended script.

Solution: Always use the /f switch in your scripts. This will ensure the command succeeds silently, whether the key is new or already exists.

Practical Example: Creating a Custom Application Settings Key​

This script is designed to be run as part of a software installation. It creates a registry key for the application and then populates it with some default values.

@ECHO OFF
SETLOCAL
REM This script should be run as an Administrator to write to HKLM.

SET "AppKey=HKLM\SOFTWARE\MyCompany\MyCoolApp\Settings"

ECHO --- Initializing Application Registry Settings ---
ECHO.

ECHO Creating the main application key...
REG ADD "%AppKey%" /f

ECHO.
ECHO Setting default values...
REM /v: Value name, /t: Type, /d: Data
REG ADD "%AppKey%" /v "InstallPath" /t REG_SZ /d "C:\Program Files\MyCompany\MyCoolApp" /f
REG ADD "%AppKey%" /v "Version" /t REG_SZ /d "1.0.0" /f
REG ADD "%AppKey%" /v "AutoUpdate" /t REG_DWORD /d 1 /f

ECHO.
ECHO --- Registry setup complete ---
REM Display the key and its values to verify.
REG QUERY "%AppKey%"

ENDLOCAL

Conclusion​

The REG ADD command is the standard and most reliable way to create new registry keys from a batch script.

Key takeaways for using it successfully:

  • Always run your script as an Administrator when modifying HKEY_LOCAL_MACHINE.
  • Always enclose the full registry key path in double quotes.
  • Always use the /f switch to ensure your script runs silently and without confirmation prompts.
  • REG ADD will automatically create any necessary parent keys in the path you provide.

Table of Contents