Skip to content

vp outdated ​

Check which dependencies have newer versions available.

bash
vp outdated
vp outdated react
vp outdated --format json
vp outdated -g

Options ​

OptionDescriptionNotes
--longShow extended information.
--format <table|list|json>Select the output format.
-r, --recursiveCheck recursively across all workspaces.
--filter <pattern>Select workspaces by pattern.Can be repeated.
-w, --workspace-rootInclude workspace root.
-P, --prodOnly production and optional dependencies.
-D, --devInclude dev dependencies.
--no-optionalExclude optional dependencies.
--compatibleShow only versions within compatible ranges.
--sort-by <field>Sort results by field.
-g, --globalCheck globally installed packages.Requires the global CLI. Uses the global package store.
--concurrency <number>Number of global package checks to run in parallel.Requires --global. Must be a positive integer.

Compatibility ​

The commands below describe project operations. Global mode is described under Options.

  • npm: npm outdated.
  • pnpm: pnpm outdated.
  • Yarn Classic: yarn outdated.
  • Yarn Modern: Alternative: yarn upgrade-interactive.
  • Bun: bun outdated.
OptionnpmpnpmYarn ClassicYarn ModernBunNotes
--longYesYesNoNoNo
--format <table|list|json>table, list, jsontable, list, jsontable, jsonNoNo
-r, --recursiveYesYesNoNoYes
--filter <pattern>YesYesNoNoYes
-w, --workspace-rootYesYesNoNoNo
-P, --prodYesYesNoNoYes
-D, --devYesYesNoNoNo
--no-optionalYesYesNoNoYes
--compatibleNoYesNoNoNo
--sort-by <field>NoYesNoNoNo
-g, --globalYesYesYesYesYes
--concurrency <number>YesYesYesYesYes

Yarn Modern does not forward positional package names. Its interactive updater can change dependencies, unlike a read-only outdated query.

Native output and exit codes differ. A nonzero exit can indicate outdated dependencies rather than a failure to query the registry.

Native Options ​

For native options, see npm outdated, pnpm outdated, Yarn upgrade-interactive, Yarn Classic outdated, and Bun outdated. To pass these options through Vite+, see Native Arguments.