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 5.9 (2021-08-20)

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

2. Mercurial 5.8 (2021-05-03)

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

3. Mercurial 5.7.1 (2021-03-08)

Regularly scheduled bug fix release.

3.1. commands

3.2. core

3.3. extensions

3.4. unsorted

4. Mercurial 5.7 (2021-01-29)

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

5. Mercurial 5.6.1 (2020-12-03)

Regularly scheduled bug fix release.

5.1. extensions

5.2. unsorted

6. Mercurial 5.6 (2020-11-02)

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

7. Mercurial 5.5.2 (2020-10-02)

Regularly scheduled bug fix release.

7.1. commands

7.2. unsorted

8. Mercurial 5.5.1 (2020-09-01)

Regularly scheduled bug fix release.

8.1. bug fixes

9. Mercurial 5.5 (2020-08-03)

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

10. Mercurial 5.4.2 (2020-07-01)

Regularly scheduled bug fix release.

10.1. extensions

10.2. unsorted

11. Mercurial 5.4.1 (2020-06-15)

Regularly scheduled bug fix release.

11.1. commands

11.2. core

11.3. unsorted

12. Mercurial 5.4 (2020-05-01)

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

13. Mercurial 5.3.2 (2020-04-02)

Regularly scheduled bug fix release.

13.1. unsorted

14. Mercurial 5.3.1 (2020-03-04)

Regularly scheduled bug fix release.

14.1. commands

14.2. extensions

14.3. unsorted

15. Mercurial 5.3 (2020-02-03)

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

16. Mercurial 5.2 (2019-11-05)

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

16.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

16.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

16.3. commands

16.4. core

16.5. extensions

16.6. unsorted

16.7. Behavior Changes

16.8. Internal API Changes

17. Mercurial 5.1.2 (2019-10-02)

Regularly scheduled bug fix release.

17.1. extensions

17.2. tests

18. Mercurial 5.1.1 (2019-09-05)

Regularly scheduled bug fix release.

18.1. commands

18.2. core

18.3. tests

19. Mercurial 5.1 (2019-08-01)

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

19.1. commands

19.2. core

19.3. extensions

19.4. unsorted

19.5. Behavior Changes

19.6. Internal API Changes

20. Mercurial 5.0.2

A regularly scheduled bugfix release.

20.1. commands

20.2. unsorted

21. Mercurial 5.0.1

A regularly scheduled bugfix release.

21.1. commands

21.2. unsorted

22. Mercurial 5.0 (2019-05-01)

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

23. Mercurial 4.9.1 (2019-03-19)

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

23.1. commands

23.2. extensions

23.3. unsorted

24. 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.

24.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.

24.2. commands

24.3. core

24.4. extensions

24.5. unsorted

24.6. Behavior Changes

24.7. Internal API Changes

25. Mercurial 4.8.2 (2019-01-07)

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

25.1. commands

25.2. core

25.3. extensions

25.4. unsorted

26. 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.

26.1. commands

26.2. core

26.3. extensions

26.4. unsorted

27. Mercurial 4.8 (2018-11-02)

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

27.1. commands

27.2. core

27.3. extensions

27.4. hgweb

27.5. chg

27.6. unsorted

27.7. Behavior Changes

27.8. Internal API Changes

28. Mercurial 4.7.2 (2018-10-01)

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

28.1. security

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

28.2. core

28.3. unsorted

29. Mercurial 4.7.1 (2018-09-04)

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

29.1. commands

29.2. core

29.3. hgweb

29.4. performance

30. 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.