# Is It There? Test-Path

Test-Path answers one question, is this file or folder there, with True or False, and it can also say whether a path is a file or a folder and whether any file matches a wildcard, so you can check before you act.

Apprentice · PowerShell · Operating System · Updated November 10, 2026

## After this lesson you can

- Check whether a file or folder is there with Test-Path, and read its True or False answer
- Tell a file from a folder with Test-Path -PathType Leaf or Container, and check for any match with a wildcard

## Key takeaways

- `Test-Path` answers True if a file or folder is there and False if it isn't, with no red error.
- True and False are a Boolean, a yes-or-no answer. PowerShell writes them `$true` and `$false`.
- `-PathType Leaf` asks "is it a file?" and `-PathType Container` asks "is it a folder?"
- A wildcard such as `photos\*.jpg` asks whether anything matches at all.

Before you drive off for the weekend, you pat your pocket: keys? Phone? Wallet? You aren't packing anything yet, only checking. The same habit saves trouble at the prompt. Before you unzip a file a friend sent, is it really in Downloads? Before you zip into a folder, does that folder exist? A tutorial says "make sure `package.json` is there before you run this", and a script that backs up your homework should check that the homework folder is where it expects. `Test-Path` is PowerShell's pat on the pocket.

This lesson uses the `road-trip` folder and the `trip-photos.zip` from *Many Files as One: Compress-Archive and Expand-Archive*. If you don't have them, run that lesson's practice-folder lines and its `Compress-Archive` line first.

## A yes-or-no question: Test-Path

Give `Test-Path` a path, and it answers with one word:

```powershell
Set-Location "$HOME\terminal-practice\road-trip"
Test-Path trip-photos.zip
Test-Path passport.pdf
```

```text
True
False
```

The zip is there; there's no `passport.pdf`. Notice what didn't happen: no red error for the missing file. `Test-Path` isn't trying to open anything, so a missing file isn't a problem to it. It's the answer to your question.

An answer that can only be True or False has a name: a **Boolean** (read "BOO-lee-un"). In PowerShell code you'll see the two answers written `$true` and `$false` (read "dollar true" and "dollar false"). The checks in this course, here and in the scripts of Module 6, all come down to one of them.

Any path works, as long as it's a full **path** or one from the folder you're in: `Test-Path "$HOME\terminal-practice\road-trip\documents\packing-list.txt"` answers `True` from anywhere.

## A file or a folder? -PathType

Sometimes "is it there?" isn't enough: you need to know what it is. `-PathType` narrows the question. `Container` means a folder, a thing that holds other things. `Leaf` means a file, the way a leaf is the end of a branch on a tree:

```powershell
Test-Path photos -PathType Container
Test-Path photos -PathType Leaf
Test-Path trip-photos.zip -PathType Leaf
```

```text
True
False
True
```

`photos` is there, but it's a folder, so "is it a file?" gets `False`.

## Is there any? Wildcards

A wildcard turns the question into "is there at least one?". `*` (read "star") stands for any letters, so `*.jpg` means "any name that ends in .jpg":

```powershell
Test-Path photos\*.jpg
Test-Path documents\*.pdf
```

```text
True
False
```

There are photos to share, and no PDFs among the documents.

## Check before you act

Here's a mistake `Test-Path` would have caught. You want to zip the documents into an `outbox` folder, but you haven't made one yet:

```powershell
Compress-Archive -Path documents -DestinationPath outbox\documents.zip
Test-Path outbox
```

```text
Compress-Archive: The path 'C:\Users\Sam\terminal-practice\road-trip\outbox' either does not exist or is not a valid file system path.
False
```

`Compress-Archive` doesn't make the folder for you, and `Test-Path` confirms why it failed. Check first, then act:

```powershell
New-Item -ItemType Directory -Path outbox
```

```text
    Directory: C:\Users\Sam\terminal-practice\road-trip

Mode                 LastWriteTime         Length Name
----                 -------------         ------ ----
d----           11/9/2026  4:01 AM                outbox
```

In a script, PowerShell can make that decision for you with `if`: "if this is True, do the first thing; otherwise (`else`), do the second". The braces, `{ }`, hold each thing to do. Module 6 teaches `if` properly; here's a first look:

```powershell
if (Test-Path outbox) { 'The outbox is ready.' } else { 'No outbox yet. Make it first.' }
```

```text
The outbox is ready.
```

**On Windows**, capital letters don't matter, so `Test-Path PHOTOS` answers `True`. **On a Mac or Linux** they do, and the same line answers `False`. Windows PowerShell 5.1 gives the same answers as PowerShell 7 to everything in this lesson.

**Try it.** Is there a `Downloads` folder in your home folder? Ask with `Test-Path "$HOME\Downloads" -PathType Container`. Then ask whether it holds any `.zip` files.

## Check yourself

2 questions to try on the lesson page.

## So what

Look before you leap, in one word. `Test-Path` costs nothing, never changes a thing, and its True or False is what every careful command and script decides on.

## Key terms

- [Test-Path](https://www.ask-codey.com/glossary/test-path)
- [Boolean](https://www.ask-codey.com/glossary/boolean)
- [Path](https://www.ask-codey.com/glossary/path-powershell)

## Cheat sheets

- [Is It There? Test-Path](https://www.ask-codey.com/cheat-sheets/powershell-test-path-cheat-sheet)

## Related

- [Many Files as One: Compress-Archive and Expand-Archive](https://www.ask-codey.com/lessons/powershell-zip-files)
- [Shortcuts to Files: Symbolic Links and Junctions](https://www.ask-codey.com/lessons/powershell-links)
- [Looking Around: Get-ChildItem](https://www.ask-codey.com/lessons/powershell-looking-around)

Source: https://www.ask-codey.com/lessons/powershell-test-path