Skip to main content

How to Right-Align Text in the Console in Batch Script

Standard Batch output is always left-aligned. However, for professional reports, tables, or dashboard headers, you may want to place text on the far right, such as a timestamp, a status indicator (e.g., [ ONLINE ]), or a page number. Right-aligning text helps utilize the full width of the terminal and creates a balanced, clean layout.

In this guide, we will demonstrate how to right-align text using string length calculation and space padding.

The Logic: Padding the Left Side​

To right-align text, you need to calculate how many spaces are needed between the left edge of the screen and the start of your text.

  1. Determine the terminal width (standard is 80 characters).
  2. Determine the length of your text.
  3. Padding = WindowWidth - TextLength.
  4. Print the padding, followed by the text.

Method 1: The Hardcoded Padding (Fastest)​

If you have a fixed-length status like [ DONE ] and want it at the end of a line, you can simply use a pre-measured string of spaces.

@echo off
echo Processing file...                                                  [ DONE ]
pause
tip

Count the total characters including the trailing text to ensure they add up to exactly 80. This method is brittle but effective for static, unchanging output lines.

Method 2: Dynamic Right-Alignment​

If your text length varies, you must calculate the padding dynamically using a loop.

Implementation Script​

@echo off
setlocal enabledelayedexpansion

:: 1. Define the text to right-align
set "text=SYSTEM MONITORING v4.2"
set "width=80"

:: 2. Calculate string length
call :strlen text len

:: 3. Calculate padding
set /a "pad=width - len"

:: 4. Validate that padding is not negative
if !pad! lss 0 set "pad=0"

:: 5. Generate the space padding string
set "padding="
for /L %%i in (1,1,!pad!) do set "padding=!padding! "

:: 6. Output
echo !padding!!text!

pause
exit /b 0

:strlen
:: %~1 = variable NAME (not value), %~2 = output variable for length
setlocal enabledelayedexpansion
set "s=!%~1!"
set "n=0"
:strlen_loop
if defined s (
    set "s=!s:~1!"
    set /a "n+=1"
    goto :strlen_loop
)
endlocal & set "%~2=%n%"
exit /b 0
warning

The :strlen function receives the variable name, not the value. Passing the value directly with call :strlen "%text%" would break if the text contains special characters such as !, ^, &, or %. By passing the name and expanding it inside the function with !%~1!, delayed expansion handles these characters safely.

Method 3: The "Flush Right" ANSI Command (Modern Windows)​

On Windows 10 version 1511 and later, you can use the ANSI absolute horizontal positioning code (ESC[columnG) to jump the cursor to a specific column regardless of how much text is currently on the line.

@echo off
setlocal

:: Generate ESC character for ANSI codes
for /f %%a in ('echo prompt $E ^| cmd') do set "ESC=%%a"

:: Print left-aligned text, then jump to column 70 for the status badge
<nul set /p "=Starting task..."
<nul set /p "=%ESC%[70G[ %ESC%[92mSUCCESS%ESC%[0m ]"
echo.

<nul set /p "=Verifying data..."
<nul set /p "=%ESC%[70G[ %ESC%[92mSUCCESS%ESC%[0m ]"
echo.

<nul set /p "=Closing handles..."
<nul set /p "=%ESC%[70G[ %ESC%[91mFAILED%ESC%[0m ]"
echo.

pause
exit /b 0
info

The ESC[70G sequence moves the cursor to column 70 on the current line. Adjust this number based on your target terminal width and the length of your status badge to prevent wrapping.

Practical Uses for Right-Alignment​

  1. Dashboard Headers: Display the tool name on the left and the current date/time on the far right.
  2. Tabular Reports: Align numerical values (like file sizes) to the right so the decimal places or units line up vertically.
  3. Status Badges: Keep your success/failure messages consistently parked at the far right of the terminal.

Best Practices​

  1. Assume 80 Columns: Even if your terminal is wider, 80 columns is the safest standard for scripts that must run on any system.
  2. Fixed-Width Fonts: Right alignment only works accurately if the user is using a monospace font, where every character occupies the same horizontal space.
  3. Handle Long Text: If your text is longer than the terminal width, right alignment will cause the text to wrap and break the visual effect. Always validate string length and either truncate or fall back to left-aligned output.
  4. ANSI Column Jump: Method 3 is the most reliable for mixed-content lines because it does not require calculating string lengths. It simply moves the cursor to a fixed anchor point on the right.
  5. Special Characters: When passing text that may contain !, ^, &, or parentheses, use variable names instead of literal values in function calls to avoid parsing errors.

Conclusion​

Right-aligning text is a subtle but powerful way to improve the visual balance of your Batch output. By using either manual padding or modern ANSI cursor jumps, you can create reports and dashboards that use the entire screen effectively, presenting information in a structured, professional manner that is much easier for users to scan and read.

Table of Contents