npm / appium
appium
What changed in appium 3, from its official release notes, upgrade guides and advisories. Sources checked 2026-10-18.
1 breaking7 new APIs and options1 behavior and defaults10 fixes and other
See which of these apply to your code, ranked, in your agent:
npx @unstale/cli initappium 319 changes
Breaking changes 1
Parses --webhook as a URI rather than as host:port.
New APIs and options 7
Installed extension commands accept package names, allowing developers to invoke them by package name.
Adds a front router for global extension middleware.
The storage plugin adds route aliases.
Adds an option to tolerate unrecognized server CLI arguments.
Drivers and plugins can communicate through IPC channels scoped to each session.
The maximum count of topics per session is limited and can be configured.
Adds three WebDriver extension endpoints.
Behavior and default changes 1
The verbose extensions list now includes repository links, helping developers identify extension source repositories.
Fixes and other changes 10
A directory is no longer treated as a CLI argument file.
Insecure feature prefixes are matched by automationName, case-insensitively.
A sibling folder is no longer treated as a subpath of the root.
The delete request now uses fs.sanitizeName to sanitize names.
Fixes plugins caching per session.
Fixes normalization of CLI arguments.
Ensures there is a single logger instance per process.
Prevents plugins from being attached to a non-existing session.
Fixed Appium symlink behavior across driver and plugin installations.
Appium injects symlinks for all installed extensions.