Extended Support Release#

plans-img Available on Enterprise plans

deployment-img self-hosted deployments

What is an Extended Support Release?#

During each monthly release, Mattermost backports security fixes and high impact bug 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 v8.1 Extended Support Release is coming to the end of its life cycle on May 15, 2024. Upgrading to Mattermost Server v9.5 Extended Support Release or later is recommended.

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 February and August 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. After a release reaches its end-of-life, no further updates will be provided for that version. Please see Release Lifecycle documentation for a full list of lifecycles for each Mattermost release.

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

Timeline-based chart showing the lifecycle of Mattermost Extended Support Releases and feature releases from last year and this year.

What is included in an Extended Support Release dot release?#

Dot releases for ESR versions will contain security fixes and high impact 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 install or upgrade guides. Please read the best practices for upgrading. Please also follow the important upgrade notes for all the versions since the current ESR version you have currently installed. Please 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



February 16, 2024

November 15, 2024




August 16, 2023

May 15, 2024




February 16, 2023

November 15, 2023




July 15, 2022

May 15, 2023




January 16, 2022

October 15, 2022




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.

If we upgrade Mobile or Desktop Apps before we upgrade to the latest ESR, will we have compatibility issues?#

Mattermost Desktop and Mobile Apps must be used with the latest Extended Support Release or a newer version of Mattermost Server.

What Mobile and Desktop App versions are compatible with the latest ESR?#

Earlier 4.x versions of Mattermost Desktop App and earlier v1.x versions of the Mobile App are backwards compatible and are supported with our supported Extended Support Releases. However, for an optimal user experience and for latest security fixes, we strongly recommend upgrading both your Mattermost Desktop and Mobile Apps to the latest version.

Please review the Desktop App changelog and the Mobile App changelog notes for any self-hosted version requirements for features and functionalities, as well as notes on security fixes.

See more details in our release lifecycle documentation.

If we upgrade to the latest ESR with a legacy E10 or E20 license key, will we have compatibility issues?#

No. Your license key is decoupled from the Mattermost server version.

We highly recommend working with your Mattermost Account Team to plan for a migration to our new plans, and to access the latest features such as persistent notifications, advanced compliance features, and call recordings.

Please contact our Sales team with questions.