Files
team/docs/main/product-overview/deprecated-features.mdx
fd3b125b31 Reconcile Product Overview content drift from docs repo (P13 sub-phase 4.1) (#37476)
* Fix broken checkmark icons and zoom-breaking tables on Plans and Cloud pages

The Plans page referenced a Sphinx-era static image path that doesn't
exist in the Docusaurus site, rendering broken icons. The Cloud
subscriptions comparison table was a mangled RST-to-MDX conversion
artifact (nested dl/dt/dd, literal ASCII borders, unresolved checkmark
substitutions) with fixed column widths that clipped content on zoom.
Both tables now use the site's checkmark.svg icon and scroll
horizontally within their own container instead of breaking the page.

* Reconcile Product Overview content drift from docs repo

Applies content that landed in mattermost/docs between 2026-05-14 and
2026-07-13 (v11.7/v11.8 server releases, v10.11 dot releases, v6.2/v5.13.7
desktop releases, v2.40-2.41.3 mobile releases, and related subscription/
FAQ/deprecation copy updates) to the corresponding MDX pages in
docs/main/product-overview, per phase P13 sub-phase 4.1 of the docs
migration plan.

* Fix duplicate changelog bullet and admin console path in Product Overview

- Remove duplicate flagged-post-visibility bullet from the v11.7.3 changelog entry.
- Correct subscription.mdx admin console path to include the Reporting menu, matching the path used elsewhere in the docs.

---------

Co-authored-by: Hanzo Dev <[email protected]>
2026-07-14 12:18:58 +03:00

252 lines
23 KiB
Plaintext
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
title: "Removed and Deprecated Features"
---
This page describes features that are removed from support for Mattermost, or will be removed in a future update (deprecated), and provides early notice about future changes that might affect your use of Mattermost. This information is subject to change with future releases, and might not include each deprecated feature.
## Upcoming deprecations
### Mattermost Server v12.0 (October 2026)
- Starting with Mattermost Server v12.0 (October 2026), RHEL 7 and RHEL 8 will no longer be supported deployment targets. This is due to Debian Bullseye reaching end-of-life in August 2026, which requires Mattermost to switch to a build environment with glibc 2.36 — incompatible with RHEL 7 (glibc 2.17) and RHEL 8 (glibc 2.28). Mattermost v11.11 (September 2026) is the last release to support RHEL 7 and RHEL 8. RHEL 9, Ubuntu 22.04/24.04 LTS, Debian Bookworm, and container-based deployments remain fully supported. Admins running RHEL 7 or RHEL 8 should plan to upgrade to RHEL 9 or migrate to another supported platform before the v12.0 release. See the [forum post](https://forum.mattermost.com/t/starting-with-mattermost-v12-0-october-2026-rhel-7-and-rhel-8-are-no-longer-supported-deployment-targets/25974) for full details and migration options.
- Starting with Mattermost Server v12.0 (October 2026), OpenSearch 1.x will no longer be a supported search backend. OpenSearch 1.x reached end-of-life on May 6, 2025, and Mattermost is setting a minimum supported version of OpenSearch 2.x going forward. Mattermost v12.0 (October 2026) is the first release that requires OpenSearch 2.x or newer; v11 releases will continue to work with 1.x while admins plan their migration. OpenSearch 2.x, 3.x, and Elasticsearch 8.x/9.x remain fully supported search backends. Admins running OpenSearch 1.x should plan to upgrade to 2.x (or migrate to Elasticsearch) before the v12.0 release. See the [forum post](https://forum.mattermost.com/t/starting-with-mattermost-v12-0-october-2026-opensearch-1-x-is-no-longer-a-supported-search-backend/25979) for full details and migration options.
- Starting with Mattermost Server v12.0 (October 2026), ``atmos/camo`` will no longer be supported as an image proxy. The ``atmos/camo`` project has been archived and is no longer maintained. If ``ImageProxySettings.ImageProxyType`` is set to ``atmos/camo``, the server will log a configuration error on startup and fail to start; the ``RemoteImageProxyURL`` and ``RemoteImageProxyOptions`` settings are also removed and will be ignored. Admins should switch to the built-in local image proxy (set ``ImageProxySettings.ImageProxyType`` to ``local``) or disable image proxying entirely (``ImageProxySettings.Enable`` set to ``false``) before upgrading. The local proxy requires no external service and includes SVG content blocking and security response headers. See the [forum post](https://forum.mattermost.com/t/starting-with-mattermost-v12-0-october-2026-atmos-camo-is-no-longer-supported-as-an-image-proxy/25980) for full details and migration options.
## Removed features by Mattermost version
### Mattermost Desktop App v6.1 (March 2026)
- The in-app auto-updater for Windows and Linux AppImage installations has been deprecated. See more details in [this forum post](https://forum.mattermost.com/t/important-update-changes-to-desktop-app-auto-updater/25657).
### Mattermost Server v11.4 (February 2026)
- Photoshop Document (PSD) files are now no longer inline previewed, they are treated as regular file attachments. This change has also been applied to v11.3.1, v11.2.3, and v10.11.11 (Extended Support Release) dot releases.
### Mattermost Mobile App v2.36.4 (January 2026)
- Removed support for iOS v15 and updated the iOS minimum version to v16. See more details in [this forum post](https://forum.mattermost.com/t/mobile-app-ios-version-support-update-v2-36-1-and-v2-36-2/25664).
### Mattermost Server v11.1 (November 2025)
- The version of React used by the Mattermost web app has been updated from React 17 to React 18. See more details in [this forum post](https://forum.mattermost.com/t/upgrading-the-mattermost-web-app-to-react-18-v11/25000).
### Mattermost Server v11.0 (October 2025)
- GitLab SSO has been deprecated from Team Edition. Deployments using GitLab SSO can remain on v10.11 ESR (with 12 months of security updates) while transitioning to our new free offering Mattermost Entry, or can explore commercial/nonprofit options. See more details in [this forum post](https://forum.mattermost.com/t/mattermost-v11-changes-in-free-offerings/25126).
- The `TeamSettings.ExperimentalViewArchivedChannels` setting has been deprecated. Archived channels will always be accessible, subject to normal channel membership. The server will fail to start if this setting is set to `false`. To deny access to archived channels, mark them as private and remove affected channel members. See more details in [this forum post](https://forum.mattermost.com/t/viewing-accessing-archived-channels-v11/22626).
- Playbooks has stopped working for Team Edition. Entry, Professional, Enterprise, and Enterprise Advanced plans are automatically upgraded to Playbooks v2 with no expected downtime. See more details in [this forum post](https://forum.mattermost.com/t/clarification-and-update-on-the-playbooks-plugin-v11/25192).
- Experimental Bleve Search functionality has been retired. If Bleve is enabled, search will not work until `DisableDatabaseSearch` is set to `false`. See more details in [this forum post](https://forum.mattermost.com/t/transitioning-from-bleve-search-in-mattermost-v11/22982).
- Support for MySQL has ended. Our [Migration Guide](https://docs.mattermost.com/deployment-guide/postgres-migration.html) outlines the steps, tools and support available for migrating to PostgreSQL. See more details in [this forum post](https://forum.mattermost.com/t/transition-to-postgresql/19551).
- The `registerPostDropdownMenuComponent` hook in the web app’s plugin API has been removed in favour of `registerPostDropdownMenuAction`. See more details in [this forum post](https://forum.mattermost.com/t/deprecating-a-post-dropdown-menu-component-plugin-api-v11/25001).
- The web app is no longer exposing the [Styled Components](https://styled-components.com/) dependency for use by web app plugins. See more details in [this forum post](https://forum.mattermost.com/t/removing-styled-components-export-for-web-app-plugins-v11/25002).
- Omnibus support has been deprecated. The last `mattermost-omnibus` release was v10.12. See more details in [this forum post](https://forum.mattermost.com/t/mattermost-omnibus-to-reach-end-of-life-v11/25175).
- Deprecated `include_removed_members` option in `api/v4/ldap/sync` has been removed. Admins can use the LDAP setting `ReAddRemovedMembers`.
- Customers that have the NPS plugin enabled can remove it as it no longer sends the feedback over through telemetry.
- Format query parameter requirement in the `/api/v4/config/client` endpoint has been deprecated.
- Removed deprecated mmctl commands and flags:
- `channel add` - use `channel users add`
- `channel remove` - use `channel users remove`
- `channel restore` - use `channel unarchive`
- `channel make-private` - use `channel modify --private`
- `command delete` - use `command archive`
- `permissions show` - use `permissions role show`
- `mmctl user email` - use `mmctl user edit email`
- `mmctl user username` - use `mmctl user edit username`
- Experimental certificate-based authentication feature has been removed. `ExperimentalSettings.ClientSideCertEnable` must be `false` to start the server.
- Added logic to migrate the password hashing method from bcrypt to PBKDF2. The migration will happen progressively, migrating the password of a user as soon as they enter it; e.g. when logging in or when double-checking their password for any sensitive action. There is an edge case where users might get locked out of their account: if a server upgrades to v11 and user A logs in (i.e., they need to enter their password), and then the server downgrades to v10.12 or previous, user A will no longer be able to log in. In this case, admins will need to manually reset the password of such users, through the system console or through the [mmctl user reset-password \[users\]](mm-ref:administration-guide%2Fmanage%2Fmmctl-command-line-tool%3Ammctl%20user%20reset-password) command. The new password hashing method is more CPU-intensive. Admins of servers with password-based login should monitor the performance on periods where many users log in at the same time.
- `/api/v4/teams/&#123;team_id&#125;/channels/search_archived` has been deprecated in favour of `/api/v4/channels/search` with the deleted parameter.
- Separate notification log file has been deprecated. If admins want to continue using a separate log file for notification logs, they can use the `AdvancedLoggingJSON` configuration. An example configuration to use is:
``` sh
{
"LogSettings": {
"AdvancedLoggingJSON": {
"notifications_file": {
"type": "file",
"format": "json",
"levels": [
{"id": 300, "name": "NotificationError"},
{"id": 301, "name": "NotificationWarn"},
{"id": 302, "name": "NotificationInfo"},
{"id": 303, "name": "NotificationDebug"},
{"id": 304, "name": "NotificationTrace"}
],
"options": {
"filename": "notifications.log",
"max_size": 100,
"max_age": 0,
"max_backups": 0,
"compress": true
},
"maxqueuesize": 1000
}
}
}
}
```
- Stopped supporting manually installed plugins as per [https://forum.mattermost.com/t/deprecation-notice-manual-plugin-deployment/21192](https://forum.mattermost.com/t/deprecation-notice-manual-plugin-deployment/21192).
- Support for PostgreSQL v13 has been removed. The new minimum PostgreSQL version is v14+. See the [minimum supported PostgreSQL version policy](/deployment-guide/software-hardware-requirements#minimum-postgresql-database-support-policy) documentation for details.
### Mattermost Server v10.8.0
- Support for legacy SKUs E10 and E20 licenses was removed. If you need assistance, [talk to a Mattermost expert](https://mattermost.com/contact-sales/).
### Mattermost Server v10.6.0
- Support for PostgreSQL v11 and v12 have been removed. The new minimum PostgreSQL version is v13+. See the [minimum supported PostgreSQL version policy](/deployment-guide/software-hardware-requirements#minimum-postgresql-database-support-policy) documentation for details.
### Mattermost Server v10.5.0
- The Mattermost server has stopped supporting manual plugin deployment. Plugins were deployed manually when an administrator or some deployment automation copies the contents of a plugin bundle into the server's working directory. If a manual or automated deployment workflow is still required, administrators can instead prepackage the plugin bundles. See more details in [this forum post](https://forum.mattermost.com/t/deprecation-notice-manual-plugin-deployment/21192).
- Mattermost has stopped official Mattermost server builds for the Microsoft Windows operating system. Administrators should migrate existing Mattermost server installations to use the official Linux builds. See more details in [this forum post](https://forum.mattermost.com/t/deprecation-notice-server-builds-for-microsoft-windows/21498).
### Mattermost Mobile App v2.25.0
- In the Mattermost Mobile App v2.25, Mattermost has stopped supporting iOS versions 13 and 14. Users should update their iOS version to v15.1 or newer. See more details in [this forum post](https://forum.mattermost.com/t/deprecation-notice-ios-13-and-14-versions/21845).
### Mattermost Server v10.4.0
- The ability to import Slack themes as Mattermost themes is no longer supported.
### Mattermost Server v10.3.0
- The Classic Mobile App has been phased out. Please download the new v2 Mobile App from the [Apple App Store](https://apps.apple.com/us/app/mattermost/id1257222717) or [Google Play Store](https://play.google.com/store/apps/details?id=com.mattermost.rn). See more details in the [classic mobile app deprecation](https://forum.mattermost.com/t/classic-mobile-app-deprecation/18703) Mattermost forum post.
### Mattermost Server v10.2.0
- Docker Content Trust (DCT) for signing Docker image artifacts has been replaced by Sigstore Cosign in v10.2 (November, 2024). If you rely on artifact verification using DCT, please [transition to using Cosign](https://edu.chainguard.dev/open-source/sigstore/cosign/how-to-install-cosign/). See [this forum post](https://forum.mattermost.com/t/upcoming-dct-deprecation/19275) for more details.
### Mattermost Server v10.0.0
- We no longer support new installations using MySQL starting in v10. All new customers and/or deployments will only be supported with the minimum supported version of the PostgreSQL database. End of support for MySQL is targeted for Mattermost v11.
- Apps Framework is deprecated for new installs. Please extend Mattermost using webhooks, slash commands, OAuth2 apps, and plugins.
- Fully deprecated the `/api/v4/image` endpoint when the image proxy is disabled.
- Removed deprecated `Config.ProductSettings`, `LdapSettings.Trace`, and `AdvancedLoggingConfig` configuration fields.
- Removed deprecated `pageSize` query parameter from most API endpoints.
- Deprecated the experimental Strict CSRF token enforcement. This feature will be fully removed in Mattermost v11.
### Mattermost Server v9.9.0
- Removed support for self-serve purchases of Mattermost Subscriptions in various flows, throughout Cloud and Self Hosted environments.
- Removed support for self-serve true up review submission in the **System Console**.
### Mattermost Server v9.5.0
- MySQL v5.7 is at end of life. We recommend all customers to upgrade to at least 8.x. From Mattermost v9.5, which is the latest Extended Support Release, we have stopped supporting MySQL v5.7 altogether.
### Mattermost Server v9.0.0
- Mattermost Boards and various other plugins have transitioned to being fully community supported. See this [forum post](https://forum.mattermost.com/t/upcoming-product-changes-to-boards-and-various-plugins/16669) for more details.
- Removed the deprecated Insights feature.
### Mattermost Server v8.0.0
- Removed `ExperimentalSettings.PatchPluginsReactDOM`. If this setting was previously enabled, confirm that:
- All Mattermost-supported plugins are updated to the latest versions.
- Any other plugins have been updated to support React 17. See the [Important Upgrade Notes](/administration-guide/upgrade/important-upgrade-notes) for v7.7 for more information.
- Deprecated Insights for all new instances and for existing servers that upgrade to Mattermost v8.0.
- Removed deprecated `PermissionUseSlashCommands`.
- Removed deprecated `model.CommandArgs.Session`.
- Removed support for PostgreSQL v10. The new minimum PostgreSQL version is now v11.
- Deprecated the `AdvancedLoggingConfig` fields, and replaced them with `AdvancedLoggingJSON` fields which accept inline JSON or a filename.
### Mattermost Server v6.0.0
- [Legacy Command Line Tools](/administration-guide/manage/command-line-tools). Most commands have been replaced by [mmctl](/administration-guide/manage/mmctl-command-line-tool) and new commands have been added over the last few months, making this tool a full and robust replacement.
- Slack Import via the web app. The Slack import tool accessible via the Team Setting menu is being replaced by the mmetl tool that is much more comprehensive for the types of data it can assist in uploading.
- MySQL versions below 5.7.12. Minimum support will now be for 5.7.12. This version introduced a native JSON data type that lets us improve performance and scalability of several database fields (most notably Users and Posts props). Additionally, version 5.6 (our current minimum version) reached [EOL in February 2021](https://www.mysql.com/support/eol-notice.html).
- Elasticsearch 5 and 6. [Versions 5.x reached EOL in March of 2019, and versions 6.x reached EOL in November 2020](https://www.elastic.co/support/eol). Our minimal supported version with Mattermost v6.0 will be Elasticsearch version 7.0.
- Windows 7 reached [EOL in January 2020](https://support.microsoft.com/en-us/windows/what-does-it-mean-if-windows-isn-t-supported-08f3b92d-7539-671e-1452-2e71cdad18b5). We will no longer provide support for the desktop app issues on Windows 7.
- [DisableLegacyMFAEndpoint](/administration-guide/configure/deprecated-configuration-settings#disable-legacy-mfa-api-endpoint) configuration setting.
- [Experimental Timezone](/administration-guide/configure/deprecated-configuration-settings#timezone) configuration setting.
- All legacy channel sidebar experimental configuration settings. We encourage customers using these settings to upgrade to v5.32 or later to access custom, collapsible channel categories among many other channel organization features. The settings being deprecated include:
- [EnableLegacySidebar](/administration-guide/configure/deprecated-configuration-settings#enable-legacy-sidebar)
- [ExperimentalTownSquareIsReadOnly](/administration-guide/configure/deprecated-configuration-settings#town-square-is-read-only)
- [ExperimentalHideTownSquareinLHS](/administration-guide/configure/deprecated-configuration-settings#town-square-is-hidden-in-left-hand-sidebar)
- [EnableXToLeaveChannelsFromLHS](/administration-guide/configure/deprecated-configuration-settings#enable-x-to-leave-channels-from-left-hand-sidebar)
- [CloseUnusedDirectMessages](/administration-guide/configure/deprecated-configuration-settings#autoclose-direct-messages-in-sidebar)
- [ExperimentalChannelOrganization](/administration-guide/configure/deprecated-configuration-settings#sidebar-organization)
- [ExperimentalChannelSidebarOrganization](/administration-guide/configure/deprecated-configuration-settings#experimental-sidebar-features)
- [All configuration settings previously marked as “Deprecated”](/administration-guide/configure/configuration-settings#deprecated-configuration-settings).
- Changes to mattermost-server/model for naming consistency.
### Mattermost Server v5.38.0
- In the v5.38 release (August 16, 2021), the “config watcher” (the mechanism that automatically reloads the “config.json“ file), has been removed in favor of the “mmctl config“ command that will need to be run to apply configuration changes after they are made. This change will improve configuration performance and robustness.
### Mattermost Server v5.37.0
- The “platform“ binary and “–platform” flag have been removed. If you are using the “–platform” flag or are using the “platform“ binary directly to run the Mattermost server application via a systemd file or custom script, you will be required to use only the “mattermost“ binary.
### Mattermost Server v5.32.0
- TLS versions 1.0 and 1.1 have been deprecated by browser vendors. Starting in Mattermost Server v5.32 (February 16), mmctl returns an error when connected to Mattermost servers deployed with these TLS versions and System Admins will need to explicitly add a flag in their commands to continue to use them. We recommend upgrading to TLS version 1.2 or higher.
### Mattermost Server v5.30.0
- PostgreSQL ended long-term support for [version 9.4 in February 2020](https://www.postgresql.org/support/versioning). From v5.26 Mattermost officially supports PostgreSQL version 10 as PostgreSQL 9.4 is no longer supported. New installs will require PostgreSQL 10+. Previous Mattermost versions, including our current ESR, will continue to be compatible with PostgreSQL 9.4. PostgreSQL 9.4 and all 9.x versions are now fully deprecated in our v5.30 release (December 16). Please follow the instructions under the Upgrading Section within [the PostgreSQL documentation](https://www.postgresql.org/support/versioning/).
### Mattermost Server v5.16.0
- Removed support for Internet Explorer (IE11) in Mattermost v5.16.0. Learn more in our [forum post](https://forum.mattermost.com/t/mattermost-is-dropping-support-for-internet-explorer-ie11-in-v5-16/7575).
### Mattermost Server v5.12.0
- ExperimentalEnablePostMetadata setting was removed. Post metadata, including post dimensions, is now stored in the database to correct scroll position and eliminate scroll jumps as content loads in a channel.
### Mattermost Server v5.6.0
- Removed support for WebRTC in beta, and replaced it with other video and audio calling solutions.
- Removed support for IE11 Mobile View due to low usage and instability in order to invest that effort in maintaining a high quality experience on other more used browsers. End users on IE11 will thus have an increased minimum screen size. Mobile View is still supported on Chrome, Firefox, Safari, Edge as well as the desktop apps.
### Mattermost Server v5.0.0
- All API v3 endpoints removed. API v3 endpoints are no longer supported as of Mattermost v4.6 release on January 16th, 2018, and are replaced by API v4 endpoints which were released on July 16th, 2017. See [https://api.mattermost.com](https://api.mattermost.com) to learn more.
- Desktop Notification Duration in Account Settings removed due to inconsistencies on various browsers and operating systems.
- An unused “ExtraUpdateAt” field removed from the channel model.
- `platform` binary renamed to mattermost for a clearer install and upgrade experience. All command line tools, including the bulk loading tool and developer tools, also renamed from platform to mattermost.
- Slash commands configured to receive a GET request now have the payload encoded in the query string instead of receiving it in the body of the request, consistent with standard HTTP requests. Although unlikely, this could break custom slash commands that use GET requests incorrectly.
- A new `config.json` setting to whitelist types of protocols for auto-linking added.
- A new `config.json` setting to disable the [permanent APIv4 delete team parameter](https://api.mattermost.com/#tag/teams%2Fpaths%2F~1teams~1%7Bteam_id%7D%2Fput) added. The setting is off by default for all new and existing installs, except those deployed on GitLab Omnibus. A System Admin can enable the API v4 endpoint from the `config.json` file.
### Mattermost Server v4.9.0
- A number of permissions configuration settings will be migrated to roles in the database, and changing their config.json values will no longer take effect. These permissions can still be modified by their respective System Console settings. See [changelog](/product-overview/unsupported-legacy-releases) for more details.
### Mattermost Server v4.0.0
- System Console settings in **Files \> Images**, including:
- Image preview height and width
- Profile picture height and width
- Image thumbnail height and width
- Font setting in **Account Settings \> Display**
- Teammate Name Display setting moved to the System Console
### Mattermost Server v3.8.0
- Old CLI tool (replaced by [an upgraded CLI tool](/administration-guide/manage/command-line-tools))
- APIv3 endpoints:
- “GET at /channels/more” (replaced by “/channels/more/&#123;offset&#125;/&#123;limit&#125;”)
- “POST at /channels/update_last_viewed_at” (replaced by “/channels/view”)
- “POST at /channels/set_last_viewed_at” (replaced by “/channels/view”)
- “POST at /users/status/set_active_channel” (replaced by “/channels/view”)
### Mattermost Server v3.7.0
- “ServiceSettings: SegmentDeveloperKey” setting in `config.json`