Skip to content

UAParser.js Version Guide

Faisal Salman edited this page Feb 25, 2026 · 1 revision

Versioning System

UAParser.js follows this versioning rule: X.Y.Z

  • X (MAJOR release) introduce some BREAKING CHANGES
  • Y (MINOR release) introduce some NEW FEATURES or DEPRECATION WARNINGS
  • Z (PATCH release) only BACKWARD COMPATIBLE CHANGES

Version Status

2.x (Main Version)

  • Actively maintained
  • Receives new features and updates
  • Best choice for most users and new development

1.x / 0.7.x (Older Versions)

  • Maintained on a limited basis
  • Mainly just backports from newer version (eg improved detection rules or important bug fixes)
  • No new features will be added
  • Use only if you need their older behavior or license terms

Migration Guide

For migration details from older versions, see the official "Migrating from v1 to v2" section in the docs:

Clone this wiki locally