Extended Support Release

Available in Mattermost Free and Starter subscription plans. Available for Mattermost Self-Hosted deployments.

What is an Extended Support Release?

During each monthly release, Mattermost backports high severity or high impact security fixes to the previous three monthly releases. Extended Support Releases (ESRs) are releases that will receive backports for security fixes and major bug fixes for the length of their life cycle.


Support for Mattermost Server v5.31 Extended Support Release has come to the end of its life cycle as of October 15, 2021. Upgrading to Mattermost Server v5.37 Extended Support Release or later is required.

What is the life cycle of an Extended Support Release?

Mattermost provides an ESR when a significant number of new features and improvements have been added to the product, and have had sufficient time to stabilize. A new ESR is released twice a year, every January and July release. An ESR is supported for nine months to provide customers with enough time to test and upgrade to the next ESR.

When an ESR is at the end of its life cycle, there will be announcements ahead of time to provide time for people to test, certify, and deploy a newer ESR version before support ends. There will be a clear upgrade path provided between ESR versions.

After a release reaches its end-of-life, no further updates will be provided for that version.

Please see Release Lifecycle documentation for full list of lifecycles for each Mattermost release.

To receive updates about Extended Support Releases, sign up for our mailing list here.


What is included in an Extended Support Release dot release?

Dot releases for ESR versions will contain high severity or high impact security fixes and bug fixes. They will not include changes to product functionality or new features.

Who should use an Extended Support Release?

ESRs are intended for organizations who value stability over having the newest features and improvements, or who have a long internal testing and certification process to undergo when upgrading.

If your organization prefers to have the newest features and improvements, Extended Support Releases may not be the best fit for you.

How do I install the Extended Support Release?

Follow our normal install or upgrade guides. Please follow the important upgrade notes for all the versions since the current ESR version you have currently installed. Please also see the changelog for list of database, API and config.json updates for each release.

When downloading the Mattermost version, choose an Extended Support Release from the list below.

What are the current supported Extended Support Release versions?



Release Date

End of Support

Latest Dot Release Download link

Upgrade Notes



July 16, 2021

April 15, 2022




January 16, 2021

October 15, 2021




July 16, 2020

April 15, 2021


The xmlsec1-based SAML library was disabled in favor of the re-enabled and improved SAML library



January 16, 2020

October 15, 2020




April 16, 2019

April 15, 2020


Please upgrade to 5.0 prior to upgrading to 5.9



May 16, 2018

July 15, 2019


How do I restore a previous Extended Support Release?

Before you perform an upgrade, please ensure you have done a full back up of your current version. You can restore the database and previous version if you need to revert an upgrade. Please note that previous ESR versions are subject to an end of support date.

Why is an Extended Support Release supported for nine months and not longer?

We chose nine months because the overhead for maintaining an ESR is high (and becomes higher the longer the support window is). If we increase the support window, it decreases how much we can develop the product. We specifically chose “ESR” instead of “LTS”, since it is not intended to be a multi-year long term support release. The nine months support timeframe will not be extended in any case.

Can customers pay for extended support?

At this point, we are not planning on letting customers pay for extended support, but we are open to discuss options for this. Please speak to your Customer Success Manager if you have additional requirements for extended support.

How do we notify customers about new and deprecated Extended Support Releases?

For a new upcoming ESR, we send out an email announcement on or close to release day. We also add a reminder on our release announcement, changelog, and via a Forum post (see example).

For a deprecated ESR, we send out an email announcement three months in advance. We also add reminders on our release announcements, changelogs, important upgrade notes, and our Forum site.

To receive updates about Extended Support Releases, sign up for our mailing list here.