Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/microsoft/winget-cli/llms.txt

Use this file to discover all available pages before exploring further.

The list command displays packages installed on your system. You can also use the ls alias.

​
Syntax

winget list [<query>] [options]

​
Arguments

​
query
string
Filter installed packages by query string

​
Filter Options

​
--id
string
Filter by package identifier
​
--name
string
Filter by package name
​
--moniker
string
Filter by package moniker
​
--tag
string
Filter by package tag
​
--command
string
Filter by command/executable name
​
-s, --source
string
Filter by source where package is registered
​
-e, --exact
flag
Use exact string matching for queries
​
-n, --count
number
Limit number of results displayed
​
--scope
string
Filter by installation scope: user or machine

​
Display Options

​
--upgrade-available
flag
Show only packages with available upgrades
​
-u, --include-unknown
flag
Include packages with unknown versions (requires —upgrade-available)
​
--include-pinned
flag
Include pinned packages (requires —upgrade-available)
​
--details
flag
Display detailed information for each package

​
Authentication

​
--header
string
Custom HTTP header for source requests
​
--authentication-mode
string
Authentication mode: silent, silentPreferred, interactive
​
--authentication-account
string
Account to use for authentication
​
--accept-source-agreements
flag
Accept all source agreements

​
Examples

List all installed packages: 
winget list
Search installed packages: 
winget list python
List by exact ID: 
winget list --id Python.Python.3.11 --exact
Show packages with updates available: 
winget list --upgrade-available
Show updates including unknown versions: 
winget list --upgrade-available --include-unknown
List from specific source: 
winget list --source msstore
Limit results: 
winget list --count 10
List packages by tag: 
winget list --tag "development"

​
Output Format

The command displays a table with the following columns:
  • Name - Package display name
  • Id - Package identifier
  • Version - Installed version
  • Available - Latest available version (if applicable)
  • Source - Source where package is registered
Name                 Id                      Version    Available   Source
--------------------------------------------------------------------
Python 3.11.4        Python.Python.3.11      3.11.4     3.11.5      winget
Microsoft PowerToys  Microsoft.PowerToys     0.70.0     0.71.0      winget
Visual Studio Code   Microsoft.VisualStudio  1.80.0                 winget

​
Exit Codes

  • 0 - Success
  • 0x8A150001 - No packages found matching query
Packages installed outside of WinGet may not have version or update information available.
Use winget list --upgrade-available as an alternative to winget upgrade for checking available updates without installing them.

Build docs developers (and LLMs) love

Get started for freeTalk to us