# Popd built-in

The popd built-in pops a directory from the directory stack.

## Syntax

- `popd [index]`

## Description

The popd built-in removes the last entry from the directory stack, returning to the previous working directory. If index is given, the entry specified by index is removed instead of the last one.

## Operands

index

  The index of a directory stack entry you want to remove.

  If omitted, `+0` (the last entry) is assumed.

## Exit status

In addition to the exit status of the cd built-in, the popd built-in returns the following exit status:

- If the `DIRSTACK` variable is read-only or empty, the exit status is 4.

- If index is out of range, the exit status is 4.

## Notes

It is an error to use this built-in when there is only one directory stack entry.

The popd built-in is an elective built-in. It cannot be used in the POSIXly-correct mode because POSIX does not define its behavior.