---
name: "pip-list"
section: "1"
platform: "linux"
package: "python-pip"
version: "26.2.2-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/pip-list"
---

# pip-list(1)

description of pip list command

## NAME

pip-list - description of pip list command

## DESCRIPTION

List installed packages, including editables.

Packages are listed in a case-insensitive sorted order.

## USAGE

```
python -m pip list [options]
```

## OPTIONS

- **-o, --outdated**

  List outdated packages

  (environment variable: **PIP\_OUTDATED**)

- **-u, --uptodate**

  List uptodate packages

  (environment variable: **PIP\_UPTODATE**)

- **-e, --editable**

  List editable projects.

  (environment variable: **PIP\_EDITABLE**)

- **-l, --local**

  If in a virtualenv that has global access, do not list globally-installed packages.

  (environment variable: **PIP\_LOCAL**)

- **--user**

  Only output packages installed in user-site.

  (environment variable: **PIP\_USER**)

- **--path \<path\>**

  Restrict to the specified installation path for listing packages (can be used multiple times).

  (environment variable: **PIP\_PATH**)

- **--format \<list\_format\>**

  Select the output format among: columns (default), freeze, or json. The 'freeze' format cannot be used with the --outdated option.

  (environment variable: **PIP\_FORMAT**)

- **--not-required**

  List packages that are not dependencies of installed packages.

  (environment variable: **PIP\_NOT\_REQUIRED**)

- **--exclude-editable**

  Exclude editable package from output.

  (environment variable: **PIP\_EXCLUDE\_EDITABLE**)

- **--include-editable**

  Include editable package in output.

  (environment variable: **PIP\_INCLUDE\_EDITABLE**)

- **--exclude \<package\>**

  Exclude specified package from the output

  (environment variable: **PIP\_EXCLUDE**)

## Author

pip developers

## Copyright

The pip developers