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.4.2 (2020-07-1)

Regularly scheduled bug fix release.

1.1. extensions

1.2. unsorted

2. Mercurial 5.4.1 (2020-06-15)

Regularly scheduled bug fix release.

2.1. commands

2.2. core

2.3. unsorted

3. Mercurial 5.4 (2020-05-01)

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

4. Mercurial 5.3.2 (2020-04-02)

Regularly scheduled bug fix release.

4.1. unsorted

5. Mercurial 5.3.1 (2020-03-04)

Regularly scheduled bug fix release.

5.1. commands

5.2. extensions

5.3. unsorted

6. Mercurial 5.3 (2020-02-03)

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

7. Mercurial 5.2 (2019-11-05)

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

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

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

7.3. commands

7.4. core

7.5. extensions

7.6. unsorted

7.7. Behavior Changes

7.8. Internal API Changes

8. Mercurial 5.1.2 (2019-10-02)

Regularly scheduled bug fix release.

8.1. extensions

8.2. tests

9. Mercurial 5.1.1 (2019-09-05)

Regularly scheduled bug fix release.

9.1. commands

9.2. core

9.3. tests

10. Mercurial 5.1 (2019-08-01)

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

10.1. commands

10.2. core

10.3. extensions

10.4. unsorted

10.5. Behavior Changes

10.6. Internal API Changes

11. Mercurial 5.0.2

A regularly scheduled bugfix release.

11.1. commands

11.2. unsorted

12. Mercurial 5.0.1

A regularly scheduled bugfix release.

12.1. commands

12.2. unsorted

13. Mercurial 5.0 (2019-05-01)

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

14. Mercurial 4.9.1 (2019-03-19)

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

14.1. commands

14.2. extensions

14.3. unsorted

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

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

15.2. commands

15.3. core

15.4. extensions

15.5. unsorted

15.6. Behavior Changes

15.7. Internal API Changes

16. Mercurial 4.8.2 (2019-01-07)

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

16.1. commands

16.2. core

16.3. extensions

16.4. unsorted

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

17.1. commands

17.2. core

17.3. extensions

17.4. unsorted

18. Mercurial 4.8 (2018-11-02)

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

18.1. commands

18.2. core

18.3. extensions

18.4. hgweb

18.5. chg

18.6. unsorted

18.7. Behavior Changes

18.8. Internal API Changes

19. Mercurial 4.7.2 (2018-10-01)

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

19.1. security

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

19.2. core

19.3. unsorted

20. Mercurial 4.7.1 (2018-09-04)

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

20.1. commands

20.2. core

20.3. hgweb

20.4. performance

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