Release Notes

Features and bugfixes in our latest releases. Please see the Download page for links to source and binaries.

Note that Mercurial follows a time-based release plan with major releases every three months and minor (bugfix) releases on the first of every month (see TimeBasedReleasePlan).

{i} Be sure to read the upgrade notes when upgrading.

(See the archive for older versions)

1. Mercurial 6.1 (2022-03-01) to 6.1.4 (2022-06-16)

Regularly scheduled major release. An overview of new features available. This is the last version to support Python 2.

2. Mercurial 6.0 (2021-11-23) to 6.0.3 (2022-02-18)

Regularly scheduled feature release. An overview of new features available. This is a regularly-scheduled quarterly feature release. It was delayed from the usual calendar due to the ongoing effort to make Windows support more robust, especially on Python 3.

3. Mercurial 5.9 to 5.9.3 (2021-08-20)

Regularly scheduled feature release. An overview of new features available. This is a regularly-scheduled quarterly feature release.

4. Mercurial 5.8 (2021-05-03)

Regularly scheduled feature release. An overview of new features available. This is a regularly-scheduled quarterly feature release.

5. Mercurial 5.7.1 (2021-03-08)

Regularly scheduled bug fix release.

5.1. commands

5.2. core

5.3. extensions

5.4. unsorted

6. Mercurial 5.7 (2021-01-29)

Regularly scheduled feature release. An overview of new features available. This is a regularly-scheduled quarterly feature release.

7. Mercurial 5.6.1 (2020-12-03)

Regularly scheduled bug fix release.

7.1. extensions

7.2. unsorted

8. Mercurial 5.6 (2020-11-02)

Regularly scheduled feature release. An overview of new features available. This is a regularly-scheduled quarterly feature release.

9. Mercurial 5.5.2 (2020-10-02)

Regularly scheduled bug fix release.

9.1. commands

9.2. unsorted

10. Mercurial 5.5.1 (2020-09-01)

Regularly scheduled bug fix release.

10.1. bug fixes

11. Mercurial 5.5 (2020-08-03)

Regularly scheduled feature release. An overview of new features available. This is a regularly-scheduled quarterly feature release.

12. Mercurial 5.4.2 (2020-07-01)

Regularly scheduled bug fix release.

12.1. extensions

12.2. unsorted

13. Mercurial 5.4.1 (2020-06-15)

Regularly scheduled bug fix release.

13.1. commands

13.2. core

13.3. unsorted

14. Mercurial 5.4 (2020-05-01)

Regularly scheduled feature release. An overview of new features available. This is a regularly-scheduled quarterly feature release.

15. Mercurial 5.3.2 (2020-04-02)

Regularly scheduled bug fix release.

15.1. unsorted

16. Mercurial 5.3.1 (2020-03-04)

Regularly scheduled bug fix release.

16.1. commands

16.2. extensions

16.3. unsorted

17. Mercurial 5.3 (2020-02-03)

Regularly scheduled feature release. An overview of new features available. This is a regularly-scheduled quarterly feature release.

18. Mercurial 5.2 (2019-11-05)

Regularly scheduled feature release. An overview of new features available. This is a regularly-scheduled quarterly feature release.

18.1. Backwards Compatibility Changes

* The infinitepush extension is believed to be unused, and will be deleted at

* 'hg grep' now searches working copy file contents by default. We recognize

18.2. API Changes

* 'mercurial.hg.update*' and 'mercurial.merge.update' now expect a value from

* 'mercurial.hg.updatetotally' is now more thorough about checking its

* 'mercurial.bookmarks.bmstore' no longer has a convenience method for looking

18.3. commands

18.4. core

18.5. extensions

18.6. unsorted

18.7. Behavior Changes

18.8. Internal API Changes

19. Mercurial 5.1.2 (2019-10-02)

Regularly scheduled bug fix release.

19.1. extensions

19.2. tests

20. Mercurial 5.1.1 (2019-09-05)

Regularly scheduled bug fix release.

20.1. commands

20.2. core

20.3. tests

21. Mercurial 5.1 (2019-08-01)

Regularly scheduled feature release. An overview of new features available. This is a regularly-scheduled quarterly feature release.

21.1. commands

21.2. core

21.3. extensions

21.4. unsorted

21.5. Behavior Changes

21.6. Internal API Changes

22. Mercurial 5.0.2

A regularly scheduled bugfix release.

22.1. commands

22.2. unsorted

23. Mercurial 5.0.1

A regularly scheduled bugfix release.

23.1. commands

23.2. unsorted

24. Mercurial 5.0 (2019-05-01)

An overview of new features available. This is a regularly-scheduled quarterly feature release.

25. Mercurial 4.9.1 (2019-03-19)

A regularly scheduled bugfix release, late due to vacations and similar disruptions at the regular time.

25.1. commands

25.2. extensions

25.3. unsorted

26. Mercurial 4.9 (2019-02-01)

An overview of new features available. This is a regularly-scheduled quarterly feature release that also contains security fixes.

26.1. security

It was possible to use symlinks and subrepositories to defeat Mercurial's path-checking logic and write files outside a repository. This has been fixed. Users on older versions can either disable subrepositories with [subrepos] allowed=false in their configuration or by ensuring any cloned repositories don't contain malicious symlinks.

26.2. commands

26.3. core

26.4. extensions

26.5. unsorted

26.6. Behavior Changes

26.7. Internal API Changes

27. Mercurial 4.8.2 (2019-01-07)

This is a regularly-scheduled bugfix release containing following fixes:

27.1. commands

27.2. core

27.3. extensions

27.4. unsorted

28. Mercurial 4.8.1 (2018-12-04)

A regularly scheduled bugfix release. Some security fixes are included, but all are expected to be low-risk.

28.1. commands

28.2. core

28.3. extensions

28.4. unsorted

29. Mercurial 4.8 (2018-11-02)

An overview of new features available. This is a regularly-scheduled quarterly feature release.

29.1. commands

29.2. core

29.3. extensions

29.4. hgweb

29.5. chg

29.6. unsorted

29.7. Behavior Changes

29.8. Internal API Changes

30. Mercurial 4.7.2 (2018-10-01)

This is a regularly-scheduled bugfix release containing following fixes:

30.1. security

Fix a potential out-of-bounds read in manifest parsing C code.

30.2. core

30.3. unsorted

31. Mercurial 4.7.1 (2018-09-04)

This is a regularly-scheduled bugfix release containing following fixes:

31.1. commands

31.2. core

31.3. hgweb

31.4. performance

32. Mercurial 4.7 (2018-08-01)

This is a regularly-scheduled quarterly feature release and has its own release notes page which can be found here Full release notes.