reg add

Adds a new subkey or entry to the registry.


reg add <keyname> [{/v valuename | /ve}] [/t datatype] [/s separator] [/d data] [/f]


Parameter Description
<keyname> Specifies the full path of the subkey or entry to be added. To specify a remote computer, include the computer name (in the format \\<computername>\) as part of the keyname. Omitting \\<computername>\ causes the operation to default to the local computer. The keyname must include a valid root key. Valid root keys for the local computer are: HKLM, HKCU, HKCR, HKU, and HKCC. If a remote computer is specified, valid root keys are: HKLM and HKU. If the registry key name contains a space, enclose the key name in quotes.
/v <Valuename> Specifies the name of the add registry entry.
/ve Specifies that the added registry entry has a null value.
/t <Type> Specifies the type for the registry entry. Type must be one of the following:
  • REG_SZ
/s <Separator> Specifies the character to be used to separate multiple instances of data when the REG_MULTI_SZ data type is specified and more than one entry is listed. If not specified, the default separator is \0.
/d <Data> Specifies the data for the new registry entry.
/f Adds the registry entry without prompting for confirmation.
/? Displays help at the command prompt.


  • Subtrees can't be added with this operation. This version of reg doesn't ask for confirmation when adding a subkey.

  • The return values for the reg add operation are:

Value Description
0 Success
1 Failure
  • For the REG_EXPAND_SZ key type, use the caret symbol ( ^ ) with % inside the /d parameter.


To add the key HKLM\Software\MyCo on remote computer ABC, type:

reg add \\ABC\HKLM\Software\MyCo

To add a registry entry to HKLM\Software\MyCo with a value named Data, the type REG_BINARY, and data of fe340ead, type:

reg add HKLM\Software\MyCo /v Data /t REG_BINARY /d fe340ead

To add a multi-valued registry entry to HKLM\Software\MyCo with a value named MRU, the type REG_MULTI_SZ, and data of fax\0mail\0, type:

reg add HKLM\Software\MyCo /v MRU /t REG_MULTI_SZ /d fax\0mail\0

To add an expanded registry entry to HKLM\Software\MyCo with a value named Path, the type REG_EXPAND_SZ, and data of %systemroot%, type:

reg add HKLM\Software\MyCo /v Path /t REG_EXPAND_SZ /d ^%systemroot^%