Menu
×
   ❮   
HTML CSS JAVASCRIPT SQL PYTHON JAVA PHP C C++ C# AWS W3.CSS HOW TO BOOTSTRAP REACT MYSQL JQUERY EXCEL XML DJANGO NUMPY PANDAS NODEJS DSA TYPESCRIPT ANGULAR ANGULARJS GIT POSTGRESQL MONGODB ASP AI R GO KOTLIN SWIFT SASS VUE GEN AI SCIPY CYBERSECURITY DATA SCIENCE INTRO TO PROGRAMMING HTML & CSS BASH RUST TOOLS

Bash Tutorial

Bash HOME Bash Intro Bash Get Started

Basic Commands

Bash Commands Bash List (ls) Bash Change Dir (cd) Bash Print Dir (pwd) Bash Echo (echo) Bash Concatenate (cat) Bash Copy (cp) Bash Move (mv) Bash Remove (rm) Bash Timestamp (touch) Bash Make Dir (mkdir) Bash Find Files (find) Bash Manual (man) Bash Alias

Pipes and Redirection

Bash Redirection Bash Pipes (|) Bash Build Commands (xargs)

Text Processing

Bash Search Text (grep) Bash Pattern Scan (awk) Bash Stream Editor (sed) Bash Remove Section (cut) Bash Sort Lines (sort) Bash View End (tail) Bash View Start (head) Bash Count (wc) Bash Unique Lines (uniq) Bash Translate (tr) Bash Compare Files (diff)

System Monitoring

Bash Process Status (ps) Bash List Processes (top) Bash Disk Space (df) Bash Directory Usage (du) Bash Memory Usage (free) Bash Terminate (kill) Bash Uptime

Networking

Bash Ping Bash URL Transfer (curl) Bash Downloader (wget) Bash Remote Connect (ssh) Bash Secure Copy (scp) Bash File Sync (rsync)

File Compression

Bash Compress (zip) Bash Extract (unzip) Bash TAR Archive

File Permissions

Bash Ownership Bash Modify (chmod) Bash Ownership (chown) Bash Group (chgrp)

Scripting

Bash Syntax Bash Script Bash Variables Bash Data Types Bash Operators Bash If...Else Bash Case Bash Loops Bash Functions Bash Script Arguments Bash Read Input (read) Bash Exit Codes Bash Arrays Bash Strings Bash Here Documents Bash Trap Signals (trap) Bash Schedule (cron)

Bash Cert

Bash Certificate

Bash Reference

Bash Glossary

Exercises and Quiz

Bash Exercises Bash Challenges Bash Quiz

Bash Script Arguments


Share

What are Arguments?

Arguments are values you give to a script when you run it, written after the script name.

Inside the script, you read them with special variables: $1 is the first argument, $2 the second, and so on.


Read Arguments

Example: Use Two Arguments

Save this as greet.sh:

#!/bin/bash
echo "Hello, $1!"
echo "Today is $2."

Run it:

./greet.sh Liam Monday
Hello, Liam!
Today is Monday.
Try it Yourself »

Wrap an argument in quotes if it contains spaces: ./greet.sh "Liam Smith" Monday.


Special Variables

  • $0: The name of the script
  • $1, $2 ...: The first, second ... argument
  • $#: The number of arguments
  • $@: All the arguments, as separate words

Example: Show the Special Variables

Save this as info.sh:

#!/bin/bash
echo "Script: $0"
echo "Number of arguments: $#"
echo "All arguments: $@"

Run it:

./info.sh red green blue
Script: ./info.sh
Number of arguments: 3
All arguments: red green blue
Try it Yourself »


Loop Through All Arguments

Use "$@" in a for loop to handle every argument. Keep the quotes, so arguments with spaces stay together:

Example: Loop Through Arguments

Save this as list.sh:

#!/bin/bash
for item in "$@"; do
  echo "Item: $item"
done

Run it:

./list.sh apple banana cherry
Item: apple
Item: banana
Item: cherry
Try it Yourself »

Check the Number of Arguments

Use $# to make sure the user gave enough arguments, and show how to use the script if not:

Example: Require an Argument

Save this as hello.sh:

#!/bin/bash
if [ $# -lt 1 ]; then
  echo "Usage: $0 name"
  exit 1
fi
echo "Hello, $1!"

Run it:

./hello.sh
Usage: ./hello.sh name
Try it Yourself »

Default Values

Use ${1:-default} to use a default value when an argument is missing:

Example: Use a Default Value

Save this as welcome.sh:

#!/bin/bash
name=${1:-World}
echo "Hello, $name!"

Run it:

./welcome.sh
Hello, World!
Try it Yourself »

Shift Arguments

The shift command removes the first argument, so $2 becomes $1, and so on:

Example: Use shift

Save this as first.sh:

#!/bin/bash
echo "First: $1"
shift
echo "Now first: $1"
echo "Left: $#"

Run it:

./first.sh one two three
First: one
Now first: two
Left: 2
Try it Yourself »


Free account

Track your progress

XP earned 0 Day streak 0 Spaces 0 League —

New

Learn in Adventure Mode W3Schools Adventure App

Coding fundamentals as bite-sized lessons and challenges.

×

Contact Sales

If you want to use W3Schools services as an educational institution, team or enterprise, send us an e-mail:
sales@w3schools.com

Report Error

If you want to report an error, or if you want to make a suggestion, send us an e-mail:
help@w3schools.com

W3Schools is optimized for learning and training. Examples might be simplified to improve reading and learning. Tutorials, references, and examples are constantly reviewed to avoid errors, but we cannot warrant full correctness of all content. While using W3Schools, you agree to have read and accepted our terms of use, cookies and privacy policy.

Copyright 1999-2026 by Refsnes Data. All Rights Reserved. W3Schools is Powered by W3.CSS.