Skip to main content

How to Set a Standard Variable in Batch Script

Variables are the most fundamental building block of any script. They are named placeholders that you can use to store and retrieve pieces of information, such as a file path, a user's name, a status message, or a number. Being able to set, change, and read variables is the key to creating dynamic and intelligent scripts that can make decisions and perform customized actions.

This guide will teach you the syntax of the core SET command, the best practices for using it safely and robustly, and the different ways you can use it to assign literal text, the contents of other variables, or even simple mathematical results.

The Core Command: SET​

The SET command is the primary tool for creating, changing, and clearing variables in a batch script.

Basic Syntax: SET VariableName=Value

  • VariableName: The name of the variable you want to create. It's best practice to use only letters, numbers, and underscores, and the name cannot contain spaces. Variable names are not case-sensitive (%MyVar% is the same as %myvar%).
  • Value: The string of text or number you want to store in the variable.

The Best Practice: The Quoted Syntax​

While the basic syntax works, it has a major flaw: it's vulnerable to spaces. The most robust and universally recommended syntax for setting a variable is to enclose the entire assignment in double quotes.

The Recommended Syntax: SET "VariableName=Value"

This simple change solves a huge number of common scripting problems, which we'll explore in the Pitfalls section. From this point on, this is the syntax we will use and recommend.

Basic Example: Storing a String​

This script creates a variable named Status and assigns it a simple text value.

@ECHO OFF
ECHO Setting a status variable...
SET "Status=Process Complete"

ECHO.
ECHO --- Reading the variable ---
ECHO The current status is: %Status%

To read the value back, you enclose the variable name in percent signs (%Status%). This is called variable expansion.

Setting a status variable...

--- Reading the variable ---
The current status is: Process Complete

Storing the Contents of Another Variable​

You can easily assign the value of one variable to another.

@ECHO OFF
SET "SourceFolder=C:\Users\Admin\Documents"

REM Assign the value of SourceFolder to BackupSource
SET "BackupSource=%SourceFolder%"

ECHO The backup source is: %BackupSource%

The command processor first expands %SourceFolder% to C:\Users\Admin\Documents and then the SET command assigns that resulting string to BackupSource.

Common Pitfalls and How to Solve Them​

Problem: Unwanted Spaces in Your Variable​

This is the most common bug for beginners. If you use the unquoted SET syntax, any spaces around the equals sign will become part of your variable's name or its value.

Example of script with error:

@ECHO OFF
REM Note the space before the = and after it.
SET MyVar = Hello World

REM This will NOT work as expected.
ECHO The value is [%MyVar%]

Output:

The value is []
note

This fails because you actually created a variable named "MyVar " (with a trailing space) and assigned it the value " Hello World" (with a leading space).

Solution: Use the Quoted Syntax​

The SET "VariableName=Value" syntax is immune to this problem. The parser correctly identifies the variable name and the value, ignoring any extraneous spaces.

REM This works perfectly.
SET "MyVar=Hello World"
ECHO The value is [%MyVar%]

Output:

The value is [Hello World]

Problem: Storing Values with Special Characters (&, |, >)​

If the value you are trying to assign contains special command characters, the unquoted syntax will fail.

Example of error in action:

REM This will FAIL. The & will be interpreted as a command separator.
SET MyTools=Hammer & Saw

Output:

'Saw' is not recognized as an internal or external command...

Solution: Use the Quoted Syntax​

Again, the SET "VariableName=Value" syntax solves this. It tells the parser to treat everything after the = as a single, literal string, regardless of its content.

REM This is the correct, safe syntax.
SET "MyTools=Hammer & Saw"
ECHO My tools are: %MyTools%

Output:

My tools are: Hammer & Saw

Practical Example: A Simple Configuration Section​

A best practice in scripting is to define all your key variables in a "configuration" block at the top of your file. This makes your script easy to read and modify.

@ECHO OFF
SETLOCAL

REM --- ===================== ---
REM --- SCRIPT CONFIGURATION    ---
REM --- ===================== ---
SET "SOURCE_DIR=C:\Users\Public\Documents\SourceData"
SET "DEST_DIR=E:\Backups\Daily"
SET "LOG_FILE=%DEST_DIR%\backup_log.txt"
SET "MODE=Incremental"

ECHO --- Starting Backup Process ---
ECHO.
ECHO Source:      "%SOURCE_DIR%"
ECHO Destination: "%DEST_DIR%"
ECHO Log File:    "%LOG_FILE%"
ECHO Mode:        %MODE%
ECHO.

ECHO Simulating backup...
ECHO %DATE% %TIME% - Backup started in %MODE% mode. >> "%LOG_FILE%"

ENDLOCAL

Conclusion​

The SET command is the heart of variable management in batch scripting. While its basic syntax seems simple, mastering its nuances is key to writing bug-free scripts.

For reliable and professional scripts:

  • The SET command creates, assigns, or clears variables.
  • The recommended, most robust syntax is SET "VariableName=Value".
  • This quoted syntax correctly handles spaces around the equals sign and allows you to store special characters without errors.
  • To read a variable's value, you expand it by enclosing its name in percent signs: %MyVar%.

Table of Contents