Back to Winget Cli

search Command

doc/windows/package-manager/winget/search.md

1.28.2403.0 KB
Original Source

search command (winget)

The search command of the winget tool queries the sources for available applications that can be installed.

The search command can show all applications available, or it can be filtered down to a specific application. The search command is used typically to identify the string to use to install a specific application.

Usage

winget search [[-q] <query>] [<options>]

The following command aliases are available:
find

Arguments

The following arguments are available.

ArgumentDescription
-q, --queryThe query used to search for an app.

Show all

If the search command includes no filters or options, it will display all available applications in the default source. You can also search for all applications in another source if you pass in just the source option.

Search strings

Search strings can be filtered with the following options.

OptionDescription
--idLimits the search to the ID of the application. The ID includes the publisher and the application name.
--nameLimits the search to the name of the application.
--monikerLimits the search to the moniker specified.
--tagLimits the search to the tags listed for the application.
--cmd, --commandLimits the search to the commands listed for the application.
-s, --sourceFind package using the specified source.
-n, --countShow no more than specified number of results (between 1 and 1000).
-e, --exactFind package using exact match.
--headerOptional Windows-Package-Manager REST source HTTP header.
--accept-source-agreementsAccept all source agreements during source operations.
--versionsShow available versions of the package.
-?, --helpGets additional help on this command.
--waitPrompts the user to press any key before exiting.
--logs, --open-logsOpen the default logs location.
--verbose, --verbose-logsEnables verbose logging for winget.
--disable-interactivityDisable interactive prompts.

The string will be treated as a substring. The search by default is also case-insensitive. For example, winget search micro could return the following:

  • Microsoft
  • Microscope
  • MyMicro

Search options

The search commands supports a number of options or filters to help limit the results.

OptionDescription
-e, --exactUses the exact string in the query, including checking for case-sensitivity. It will not use the default behavior of a substring.
-n, --countRestricts the output of the display to the specified count.
-s, --sourceRestricts the search to the specified source name.