The dir command is a Command Prompt command used to display a list of the files and subfolders contained in a folder.
For each file or folder listed, the command will, by default, show the date and time the item was last changed, if the item is a folder (labeled with DIR) or file, the size of the file if applicable, and finally the name of the file or folder including the file extension.
Outside of the file and folder list, the dir command also displays the current drive letter of the partition, the volume label, volume serial number, total number of files listed, total size of those files in bytes, the number of subfolders listed, and the total bytes remaining free on the drive.
Dir Command Availability
The dir command is available from within the Command Prompt in all Windows operating systems including Windows 11, Windows 10, Windows 8, Windows 7, Windows Vista, and Windows XP.
Older versions of Windows include the dir command as well but with a few fewer options than we have listed below. The dir command is also a DOS command, available in all versions of MS-DOS.
The dir command can be found in offline Command Prompt versions, like the ones available from Advanced Startup Options and System Recovery Options. The dir command is also included in the Recovery Console in Windows XP.
Dir Command Syntax
dir [drive:][path][filename] [/a[[:]attributes]] [/b] [/c] [/d] [/l] [/n] [/o[[:]sortorder]] [/p] [/q] [/r] [/s] [/t[[:]timefield]] [/w] [/x] [/4]
The availability of certain dir command switches and other dir command syntax may differ from operating system to operating system.
See How to Read Command Syntax if you’re not sure how to interpret the syntax of the dir command as it’s written above or shown in the table below.
Dir Command Examples
Below are some of the different ways you can use the dir command:
a = archive files
d = directories
h = hidden files
i = not content indexed files
l = reparse points
r = read-only files
s = system files
v = integrity files
x = no scrub files
- = Use this as a prefix to any of the above attributes to exclude items with those file attributes from the results.
Considering the volume of information that the dir command usually returns, saving all of it to a text file via a redirection operator is usually a smart idea. See How to Redirect Command Output to a File for more on how to do this.
Run Without Switches
dir
In this example, the dir command is used alone, without any drive:, path, filename specifications, nor any switches, producing a result like this:
C:>dir
Volume in drive C has no label.
Volume Serial Number is F4AC-9851
Directory of C:
09/02/2015 12:41 PM
$SysReset
05/30/2016 06:22 PM 93 HaxLogs.txt
05/07/2016 02:58 AM PerfLogs
05/22/2016 07:55 PM Program Files
05/31/2016 11:30 AM Program Files (x86)
07/30/2015 04:32 PM Temp
05/22/2016 07:55 PM Users
05/22/2016 08:00 PM Windows
05/22/2016 09:50 PM Windows.old
1 File(s) 93 bytes
As you can see, the dir command was executed from the root directory of C (i.e., C:>). Without specifying where exactly to list the folder and file contents from, the command defaults to displaying this information from where the command was executed.
List Hidden Items
dir c:\users /ah
In the above example, we’re requesting that the dir command show results from the drive: and path of c:\users, not from the location we’re running the command from. We’re also specifying, via the /a switch with the h attribute, that we’d like to only see hidden items, resulting in something like this:
C:>dir c:\users /ah Volume in drive C has no label. Volume Serial Number is F4AC-9851 Directory of c:\users 05/07/2016 04:04 AM All Users [C:\ProgramData] 05/22/2016 08:01 PM Default 05/07/2016 04:04 AM Default User [C:\Users\Default] 05/07/2016 02:50 AM 174 desktop.ini 1 File(s) 174 bytes
The small list of directories and the single file you see in the result above doesn’t make up the entirety of the c:\users folder—just the hidden files and folders. To see all files and folders, you would execute dir c:\users /a (removing the h) instead.
Search for File In Any Folder
dir c:*.csv /s /b > c:\users\tim\desktop\csvfiles.txt
In this slightly more complex, but much more practical, example for the dir command, we’re requesting that our entire hard drive be searched for CSV files and then the bare minimum results are outputted to a text document. Let’s look at this piece by piece:
- c:*.csv tells the dir command to look at all files (*) that end in the CSV (.csv) extension in the root of the c: drive.
- /s instructs it to go deeper than the root of c: and instead, search for files like this in every folder, as deep as the folders go.
- /b removes anything but the path and file name, essentially creating a readable “list” of these files.
is a redirection operator, meaning “send to” somewhere.
- c:\users\tim\desktop\csvfiles.txt is the destination for the > redirector, meaning that results will be written to the csvfiles.txt file instead of in Command Prompt, which will be created at the c:\users\tim\desktop location (i.e., the Desktop you see when you’re logged in).
When you redirect command output to a file, as we did here in this dir command example, Command Prompt doesn’t display anything. However, the exact output you would have seen is instead located inside that text file. Here’s what our csvfiles.txt looked like after the dir command had completed:
c:\ProgramData\Intuit\Quicken\Inet\merchant_alias.csv c:\ProgramData\Intuit\Quicken\Inet\merchant_common.csv c:\Users\All Users\Intuit\Quicken\Inet\merchant_alias.csv c:\Users\All Users\Intuit\Quicken\Inet\merchant_common.csv c:\Users\Tim\AppData\Roaming\condition.2.csv c:\Users\Tim\AppData\Roaming\line.csv c:\Users\Tim\AppData\Roaming\media.csv
While you certainly could have skipped the file redirection, and even the “bare format” switch, the results would have been very difficult to work within the Command Prompt window, making it hard to get to what you were after.
Related Commands
The dir command is often used with the del command. After using dir to find the name and location of the file(s) in any particular folder(s), del can be used to delete files directly from the Command Prompt.
Similar is the rmdir /s command, and older deltree command, used to delete folders and files. The rmdir command (without the /s option) is useful for deleting empty folders that you find with the dir command.
As mentioned above, the dir command is also often used with a redirection operator.
Get the Latest Tech News Delivered Every Day
How to Redirect Command Output to a File
Vol Command Examples and Options
More Command
Xcopy Command
Copy Command
Rename Command
How to Use the Netstat Command
Net Send Command
What Is a Redirection Operator?
Sfc Command (System File Checker)
Net Command
How to Use the Net Use Command in Windows
How to Restore Deleted Files From the Recycle Bin
What Is a DIRECTORY File?
Msg Command (Examples, Switches, and More)
How to Verify File Integrity in Windows With FCIV
Facebook
Twitter
Hit Refresh on Your Tech News
About Us
Privacy Policy
Editorial Guidelines
Terms of Use
Careers
Advertise
Contact
EU Privacy
NEWS
HOW TO
FEATURES
ABOUT US