Skip to main content

How to Use the @ Symbol in a Batch Script

When you first start writing batch scripts, one of the first things you'll notice is that every command you write is printed ("echoed") to the command prompt window before its output is shown. This creates a lot of screen clutter and can make your script's actual output hard to read. The key to creating clean, professional-looking scripts is to control this command echoing.

This guide will explain the fundamental concept of command echoing and the role of the special @ symbol. You will learn how @ is used on its own and, more importantly, how it is used in the single most common line in all of batch scripting: @ECHO OFF.

Understanding Command Echoing (The Default Behavior)​

By default, the command prompt is in an "echo on" state. This means it displays a fresh prompt and then "types out" each command before it is executed. This is useful for debugging because you can see exactly what is being run.

For example, a script without any echo control:

REM My first script
ECHO Hello, World!
PAUSE

Notice in the output how each command line (ECHO ... and PAUSE) is printed before its result.

C:\Scripts>REM My first script

C:\Scripts>ECHO Hello, World!
Hello, World!

C:\Scripts>PAUSE
Press any key to continue . . .

Turning Off Echoing with ECHO OFF​

To prevent this clutter, batch scripting provides the ECHO OFF command. When this command is run, it instructs the command processor to stop echoing all subsequent commands for the rest of the script's execution.

For example, the following script is with ECHO OFF:

ECHO OFF
REM My second script
ECHO Hello, World!
PAUSE

This output is much cleaner, but there's still one problem: the ECHO OFF command itself is echoed to the screen before it can take effect.

C:\Scripts>ECHO OFF
Hello, World!
Press any key to continue . . .

The Role of the @ Symbol: Suppressing a Single Line​

This is where the @ symbol comes in. The @ symbol is a special command prefix that tells the command processor to not echo the single line that it precedes. The command on that line is still executed, but the command text itself is not displayed.

Let's use @ on our PAUSE command.

@ECHO OFF
ECHO Hello, World!
@PAUSE

The @ here is redundant because ECHO OFF is already active, but it demonstrates the concept. The PAUSE command will run, but you won't see C:\Scripts>PAUSE printed first.

The Perfect Combination: @ECHO OFF​

Now we can solve the problem from Section above. We want to turn off echoing for the whole script, but we also don't want the ECHO OFF command itself to be visible.

The solution is to use the @ symbol on the ECHO OFF command.

Syntax: @ECHO OFF

How it works:

  1. The command processor sees the @ symbol at the beginning of the line.
  2. The @ tells it, "Do not echo the command on this specific line."
  3. The command ECHO OFF is then executed silently.
  4. From this point forward, the "echo off" state is active, and no subsequent commands will be echoed.

This is why @ECHO OFF is the standard, professional first line for virtually every batch script ever written.

The Perfect Script:

@ECHO OFF
REM My final script
ECHO Hello, World!
PAUSE

This output is perfectly clean. The user only sees the output that you explicitly want them to see.

Hello, World!
Press any key to continue . . .

Using @ with Other Commands​

While its most famous use is with ECHO OFF, the @ symbol can be used to prefix any command to make that single line silent, even if ECHO is currently on.

@ECHO ON
ECHO This command is visible.
@ECHO This command is NOT visible, but its output is.
ECHO This command is visible again.

Output:

C:\Scripts>ECHO This command is visible.
This command is visible.
This command is NOT visible, but its output is.

C:\Scripts>ECHO This command is visible again.
This command is visible again.

Common Pitfalls and Best Practices​

  • Overusing @: A common mistake for beginners is to put @ in front of every single line in their script. This is highly redundant and inefficient.

    • Best Practice: Just use @ECHO OFF as the first line and let it handle everything. There is almost never a need to use @ on any other line.

  • Debugging with ECHO ON: The main reason you would ever want to see commands being echoed is for debugging. If your script is behaving strangely, you can temporarily remove @ECHO OFF or add an ECHO ON line to a specific section. This will show you exactly what commands are being executed and how your variables are being expanded, which can be invaluable for finding bugs.

Conclusion​

The @ symbol is a simple but fundamental part of writing clean and professional batch scripts.

  • By default, cmd.exe is in an "echo on" state, showing every command it runs.
  • The ECHO OFF command disables this behavior for all subsequent commands.
  • The @ symbol is a prefix that disables echo for only the single line it is on.
  • The combination @ECHO OFF is the standard first line for all scripts because it uses @ to silently execute the ECHO OFF command, resulting in a completely clean output for the rest of the script.

Table of Contents