Skip to main content

How to Use ECHO ON vs. ECHO OFF in Batch Script

The ECHO command in batch scripting has a dual personality. Its most common use is for printing text to the screen (e.g., ECHO Hello, World!). However, its other, more fundamental role is to control a feature called command echoing. This feature determines whether the commands in your script are displayed on the screen as they are executed.

This guide will explain the crucial difference between the ECHO ON and ECHO OFF states. You will learn why almost every script starts with @ECHO OFF and how you can use these commands to make your scripts either clean and professional or noisy and easy to debug.

The Core Concept: Command Echoing​

Command echoing is a feature of the cmd.exe interpreter. When it is ON, the interpreter will first print (or "echo") the command it is about to run to the console, and then it will execute it. This is useful for seeing the flow of your script and how variables are being expanded. When it is OFF, the interpreter will execute the commands silently, and you will only see the output of those commands.

The Default State: ECHO ON​

If you open a new command prompt, the default state is ECHO ON. If you create a batch script without any ECHO commands to control the state, it will run with echoing enabled.

For example:

NoisyScript.bat
REM This script has no ECHO OFF command.
SET "MyVar=Hello"
ECHO %MyVar%

The output is "noisy." You see every command, including comments, before you see its result. This can be confusing for an end-user.

C:\Scripts>REM This script has no ECHO OFF command.

C:\Scripts>SET "MyVar=Hello"

C:\Scripts>ECHO Hello
Hello

The Clean State: ECHO OFF​

The ECHO OFF command disables command echoing for all subsequent commands in the script. This results in clean, professional-looking output where the user only sees the results of the script, not the code itself.

For example:

CleanScript.bat
ECHO OFF
REM This script has ECHO OFF.
SET "MyVar=Hello"
ECHO %MyVar%

This output is much cleaner. You only see the final output of the ECHO %MyVar% command.

C:\Scripts>ECHO OFF
Hello

But notice that the ECHO OFF command itself was still echoed to the screen before it could take effect. This leads to the final piece of the puzzle.

The @ Symbol: Hiding the ECHO OFF Command Itself​

The @ symbol, when placed as the very first character on a command line in a batch script, has a special meaning: it suppresses the echoing of that single line, regardless of the current ECHO state.

By combining @ with ECHO OFF, you get the best of both worlds. The @ hides the ECHO OFF command, and then the ECHO OFF command takes effect and hides all the commands that follow.

The Standard Script Header: @ECHO OFF

This is the standard, professional way to start almost every batch script.

Example with @ECHO OFF​

ProfessionalScript.bat
@ECHO OFF
REM This script starts with @ECHO OFF.
SET "MyVar=Hello"
ECHO %MyVar%

The only thing printed to the console is the output that you explicitly wanted the user to see.

Hello

Why @ECHO OFF is the Professional Standard​

Using @ECHO OFF at the beginning of your script is considered a best practice for several reasons:

  • User Experience: It provides a clean and uncluttered output, showing the user only what they need to see.
  • Clarity: It hides the implementation details of your script, making the output less confusing.
  • Professionalism: It signals that the script was written deliberately and is intended for use by others.

Using ECHO ON for Debugging​

While ECHO OFF is the standard for finished scripts, ECHO ON is an invaluable debugging tool. If your script is behaving unexpectedly, the first thing you should do is remove the @ECHO OFF line (or change it to @ECHO ON).

When you run the script with echoing enabled, you can see:

  • The exact commands being run.
  • How your variables are being expanded (or failing to expand).
  • The exact point where the script is failing.

This is often the fastest way to find a bug in your logic or syntax.

How to Check the Current State​

If you want to know the current state of command echoing, you can run the ECHO command with no arguments.

C:\> ECHO
Echo is on.

Conclusion​

The ECHO ON and ECHO OFF commands are not for printing text, but for controlling the verbosity of the script's execution.

Key takeaways:

  • ECHO ON: The default state. Shows every command before it is executed. It is noisy but great for debugging.
  • ECHO OFF: A command to disable the echoing feature for all subsequent commands.
  • @: A special symbol that hides the echoing of the single line it precedes.
  • @ECHO OFF: The standard, professional combination to start almost every batch script. It provides a clean, user-friendly output.

Table of Contents