v10 changelog#

Important

Support for Mattermost Server v9.5 Extended Support Release has come to the end of its life cycle on November 15, 2024. Upgrading to Mattermost Server v9.11 or later is required.

  • Upgrading from ESR-to-ESR (major -> major_next) is fully supported and tested. However, upgrading from ESR-to-ESR (major to major+2) is supported, but not tested. If you plan to upgrade across multiple releases, we strongly recommend upgrading from an ESR to another ESR. For example, if you’re upgrading from the v8.1 ESR, upgrade to the v9.5 ESR or the v9.11 ESR.

  • See the Important Upgrade Notes documentation for details on upgrading to a newer release.

  • See the changelog in progress for details about the upcoming release.

Release v10.2 - Feature Release#

Release Day: November 15, 2024

Important Upgrade Notes#

Important

If you upgrade from a release earlier than v10.0, please read the other Important Upgrade Notes.

Improvements#

User Interface (UI)#

  • Pre-packaged Calls plugin v1.2.1.

  • Changed the logic of useMilitaryTime to false to default to 12-hour time format unless the user’s preference from data.Value is true. When a notification email is sent to a user, the time should now default to the 12-hour format unless otherwise stated by the user.

  • A warning is now shown when deleting a post or comment from a remote/shared channel.

  • Bot messages will now properly mention both users when they happen on non-bot Direct Messages.

  • Updated the channel header to hide pinned posts when there aren’t any in the channel.

  • Added full support for @mentions in the values of fields in message attachments.

Administration#

  • Added a new URL parameter called permanent to DELETE /api/v4/posts/<post-id>, and set permanent to true in order to permanently delete a post and its attachments.

  • Added Shared Channels administration page to the System Console.

  • Added a team selector to accept connection invite flow in Shared Workspaces.

  • Restricted activation and deactivation of LDAP-managed users through both the System Admin Console UI and Mattermost API.

  • Export/import improvements: added the ability to export all user preferences and flagged posts.

  • Increased timeouts to fetch cluster logs.

  • Improved log messages for cluster communication.

  • Information about deleted rows from the Data Retention job are now logged.

  • License details to logs are now emitted when added or removed.

  • Added a new mmctl command, mmctl post delete <post-id>, in order to permanently delete a post and its attachments.

Performance#

  • Added metrics to prometheus to check the mobile versions for each session daily.

  • Improved the performance of LDAP sync jobs when group-contained teams and channels are used.

  • Added minor improvements to notification metrics.

  • Added minor improvements to mobile push notifications.

Bug Fixes#

  • Fixed an issue with email notifications using 24-hour timestamps by default.

  • Fixed an issue where bots were not ignored when counting deactivated accounts for statistics.

  • Fixed an issue where drafts didn’t allow scrolling if the user had many drafts.

  • Fixed an issue that caused Javascript errors in the System Console.

  • Fixed racy use of session in NewWebConn.

  • Fixed a race condition that would happen after a server start if EnableTesting was enabled.

  • Fixed an issue where no error message was shown when replying to a deleted post from the draft screen.

  • Fixed an issue where the check icons were missing from the Sort and Show options in the Direct Messages tab, and the Sort tab of the Channels tab.

  • Fixed desyncing issues with unreads between the team sidebar and the title bar.

  • Fixed an issue with message export file attachments with dedicated filestore: when the dedicated filestore is set, file attachments will be found and exported correctly.

  • Reverted a change enforcing usernames to start with alpha characters on the server.

  • Reverted a breaking change in registerSlashCommandWillBePostedHook that caused errors to surface in case an expected empty object was returned.

config.json#

New setting options were added to config.json. Below is a list of the additions and their default values on install. The settings can be modified in config.json, or the System Console when available.

Changes to all plans:#

  • Under ServiceSettings in config.json:

    • Added a new configuration setting EnableAPIPostDeletion in order to enable/disable post deletion. This configuration setting does not need to be enabled when running mmctl in local mode.

    • Added EnableDesktopLandingPage to allow the desktop app landing page to be disabled.

  • Under NativeAppSettings in config.json:

    • Added a configuration setting MobileExternalBrowser that tells the Mobile app to perform SSO Authentication using the external default browser.

Go Version#

  • v10.2 is built with Go v1.22.6.

Known Issues#

  • The scrollbar is not clickable when there is a “Jump to recents” toaster MM-61526.

  • Shared Channels: Direct Messages are not supported.

  • Searching stop words in quotation marks with Elasticsearch enabled returns more than just the searched terms.

  • Slack import through the CLI fails if email notifications are enabled.

  • The Playbooks left-hand sidebar doesn’t update when a user is added to a run or playbook without a refresh.

  • If a user isn’t a member of a configured broadcast channel, posting a status update might fail without any error feedback. As a temporary workaround, join the configured broadcast channels, or remove those channels from the run configuration.

Contributors#

Release v10.1 - Feature Release#

  • 10.1.3, released 2024-11-14

    • Mattermost v10.1.3 contains medium severity level security fixes. Upgrading to this release is recommended. Details will be posted on our security updates page 30 days after release as per the Mattermost Responsible Disclosure Policy.

    • Reverted a change enforcing usernames to start with alpha characters on the server MM-61143.

    • Reverted a breaking change in registerSlashCommandWillBePostedHook that caused errors to surface in case an expected empty object was returned MM-61233.

    • Mattermost v10.1.3 contains no database or functional changes.

  • 10.1.2, released 2024-10-28

    • Mattermost v10.1.2 contains a high severity level security fix. Upgrading to this release is recommended. Details will be posted on our security updates page 30 days after release as per the Mattermost Responsible Disclosure Policy.

    • Fixed an issue with message export file attachments with a dedicated filestore MM-60063.

    • Mattermost v10.1.2 contains the following functional change:

      • Added a configuration setting NativeAppSettings > MobileExternalBrowser that tells the Mobile app to perform SSO Authentication using the external default browser MM-60332.

  • 10.1.1, released 2024-10-16

    • Fixed an issue where a shared indicator was shown in all Direct Messages, regardless of the user coming from a shared server MM-60744.

    • Mattermost v10.1.1 contains no database or functional changes.

  • 10.1.0, released 2024-10-16

    • Original 10.1.0 release.

Important

If you upgrade from a release earlier than v10.0, please read the other Important Upgrade Notes.

Improvements#

User Interface (UI)#

  • Added Metrics plugin to the prepackaged plugins, v0.5.3.

  • Pre-packaged Calls plugin v1.1.0.

  • Enabled Channel Bookmarks, added re-ordering, and fixed URL validity checking.

  • Added a more descriptive error message, “Uploaded plugin size exceeds limit.” for plugin uploads that are too large.

  • Added channel specific message notification sounds configuration.

Administration#

  • Added DeleteAt field for SharedChannelRemotes and RemoteClusters.

  • Added support for sending channel invites to offline remotes in Shared Channels.

  • Changed server-side logic to return a 413: Request Entity Too Large HTTP status code for a plugin upload that is too large.

  • Direct and Group Message unread/read state over export and import will now be carried over.

  • CRT memberships are now importable for import.

  • CRT memberships are now exportable for bulk export.

  • Added --local mode support in MMCTL to handle user preferences.

  • Plugins are now allowed to mark setting fields as secret, obfuscating them in the System Console and the Support Packet.

Performance#

  • Improved metrics related to push proxy errors.

  • Improved metrics around notifications.

Bug Fixes#

  • Fixed an issue where threads would be marked as read if they were open in the background.

  • Fixed an issue where Direct and Group Messages didn’t load correctly in the sidebar when refreshing the app from Drafts.

  • Fixed an issue attempting to bind to Apps plugin when the plugin was not enabled.

  • Fixed an issue where the Unreads tab would not update correctly after the websocket reconnected.

  • Fixed an issue with focusing on the main box when loading the app.

  • Fixed an issue where Team and Channel Admins could lose the ability to create posts in a moderated channel.

  • Fixed an issue where marking a channel as unread did not show immediately in other clients.

  • Fixed an issue with not allowing to use @ and ~ in the in: search modifier without affecting search results.

  • Fixed an issue with YouTube previews no longer being displayed.

config.json#

New setting options were added to config.json. Below is a list of the additions and their default values on install. The settings can be modified in config.json, or the System Console when available.

Changes to all plans:#

  • Under ExperimentalSettings in config.json:

    • Added YoutubeReferrerPolicy to fix an issue where YouTube previews showed an “Video Unavailable” error instead of the video.

Changes to the Enterprise plan:#

  • Under ConnectedWorkspacesSettings in config.json:

    • Added DisableSharedChannelsStatusSync to add status sync support to Shared Channels.

  • Under ConnectedWorkspacesSettings in config.json:

    • Moved the Shared Channel related configuration properties out of the Experimental section.

    • Added the MaxPostsPerSync configuration property.

API Changes#

  • Added new API endpoints to manage shared channels.

  • Added proper response to /api/v4/client_perf endpoint.

Go Version#

  • v10.1 is built with Go v1.22.6.

Known Issues#

  • Searching stop words in quotation marks with Elasticsearch enabled returns more than just the searched terms.

  • Slack import through the CLI fails if email notifications are enabled.

  • The Playbooks left-hand sidebar doesn’t update when a user is added to a run or playbook without a refresh.

  • If a user isn’t a member of a configured broadcast channel, posting a status update might fail without any error feedback. As a temporary workaround, join the configured broadcast channels, or remove those channels from the run configuration.

Contributors#

Release v10.0 - Major Release#

  • 10.0.3, released 2024-11-14

  • 10.0.2, released 2024-10-28

    • Mattermost v10.0.2 contains a high severity level security fix. Upgrading to this release is recommended. Details will be posted on our security updates page 30 days after release as per the Mattermost Responsible Disclosure Policy.

    • Reverted a change enforcing usernames to start with alpha characters on the server MM-61143.

    • Reverted a breaking change in registerSlashCommandWillBePostedHook that caused errors to surface in case an expected empty object was returned MM-61233.

    • Mattermost v10.0.2 contains no database or functional changes.

  • 10.0.1, released 2024-10-10

    • Mattermost v10.0.1 contains low to medium severity level security fixes. Upgrading to this release is recommended. Details will be posted on our security updates page 30 days after release as per the Mattermost Responsible Disclosure Policy.

    • Fixed an issue enabling Professional customers and Team Edition users to upgrade to Playbooks v2 via the in-product marketplace, which fails to start without an Enterprise License. Additional details and discussion can be found on the forums here MM-60679.

    • Mattermost v10.0.1 contains no database or functional changes.

  • 10.0.0, released 2024-09-16

    • Original 10.0.0 release.

Important Upgrade Notes#

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

  • Mattermost v10 introduces Playbooks v2 for all Enterprise licensed customers. Professional SKU customers may continue to use Playbooks v1 uninterrupted which will be maintained and supported until September 2025, followed by an appropriate grandfathering strategy. More detailed information and the discussion are available on the Mattermost discussion forum.

  • Renamed Channel Moderation to Advanced Access Control in the channel management section in the System Console.

  • Renamed announcement banner feature to “system-wide notifications”.

  • Renamed “Collapsed Reply Threads” to “Threaded Discussions” in the System Console.

  • Renamed “System Roles” to “Delegated Granular Administration” in the System Console.

  • Renamed “Office 365” to “Entra ID” for SSO logins.

  • Fully deprecated the /api/v4/image endpoint when the image proxy is disabled.

  • Pre-packaged Calls plugin v1.0.1. This includes breaking changes including removal of group calls from unlicensed servers in order to focus supportability and quality on licensed servers. Unlicensed servers can continue to use Calls in direct message channels, which represent the majority of activity.

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

Important

If you upgrade from a release earlier than v9.11, please read the other Important Upgrade Notes.

Highlights#

See this walkthrough video on some of the highlights and improvements in our latest release below.

Mattermost Microsoft Teams Plugin#

  • Pre-packaged the Microsoft Teams plugin for Mattermost, v2.0.3.

Mattermost Microsoft Calendar and Microsoft Teams Meetings Plugins#

  • Pre-packaged Microsoft Calendar v1.3.4 and Microsoft Teams Meetings v2.2.0 plugins.

Mattermost Copilot GA#

  • Pre-packaged Mattermost Copilot plugin version v1.0.0.

Improvements#

User Interface (UI)#

  • Pre-packaged Calls plugin v1.0.1.

  • Added Playbooks v2.0.1 to the prepackaged plugins.

  • Added Mattermost user survey plugin to pre-packaged plugins, v1.1.1.

  • Changed the right-hand side scroll direction and fixed the advanced text editor to the bottom.

  • Added Do not disturb and late timezone warnings to Direct Message posts.

  • Added user statuses to the Group Members modal.

  • Added labels for channel header and purpose in the right-hand side channel info view.

  • Added pagination user interface to the BackstageList component.

  • Made various improvements to code involving user preferences.

  • Promoted GIF picker, custom groups and message priority out of Beta.

  • Removed the Pre-release features section from Settings > Advanced due to lack of usage.

Administration#

  • Made payload size limit error more clearly visible and recognisable in API responses and server error logs.

  • Extended the plugin schema to support defining sections for System Console settings.

  • Added support for a default team on secure connections for incoming channel invites.

  • Remote clusters can now be created without explicitly providing a password.

  • Files are now fetched from all nodes in a cluster when generating a Support Packet.

  • Docker images are now based on Ubuntu Noble.

Performance#

  • Removed a re-render on channel change.

  • Batched requests made by certain components for loading users and their statuses from the server.

  • Cleaned up some unused post handling logic.

Bug Fixes#

  • Fixed an issue with web app notifications not being shown in the Notification Center on Windows or Mac.

  • Fixed an issue with mmctl webhooks list to paginate past 200 results.

  • Fixed an issue where scrolling capability and a visible scrollbar were missing in post textboxes.

  • Fixed an issue where false warnings about Channel indexes being incorrect were sent to system admins.

  • Fixed an issue where indexing would always be done async even after setting LiveIndexingBatchSize to 1. Now we respect the config and index synchronously if the value is set to 1.

  • Fixed an issue where the Edit Post Time Limit button was not being displayed in the System Console.

  • Fixed another issue where users would not see channels they were added to/messages from those channels in clustered environments.

config.json#

New setting options were added to config.json. Below is a list of the additions and their default values on install. The settings can be modified in config.json, or the System Console when available.

Changes to all plans:#

  • Under ServiceSettings in config.json:

    • Added a new setting MaximumURLLength to remove the hardcoded URL length limit.

  • Removed deprecated Config.ProductSettings.

  • Removed EnablePreviewFeatures setting.

Changes to the Enterprise plan:#

  • Removed deprecated LdapSettings.Trace setting.

  • Removed deprecated AdvancedLoggingConfig setting.

API Changes#

  • Reduced the number of API requests made to fetch user information for Group Messages on page load.

  • User APIs now enforce username beginning with alphabetic character, matching client-side validation.

  • Added a new request parameter include_total_count to API endpoint GET /api/v4/hooks/incoming.

Go Version#

  • v10.0 is built with Go v1.21.8.

Open Source Components#

  • Added redis/rueidis to https://github.com/mattermost/mattermost.

Known Issues#

  • The cursor is not placed in the “Write to” field on login MM-60275.

  • Searching stop words in quotation marks with Elasticsearch enabled returns more than just the searched terms.

  • Slack import through the CLI fails if email notifications are enabled.

  • The Playbooks left-hand sidebar doesn’t update when a user is added to a run or playbook without a refresh.

  • If a user isn’t a member of a configured broadcast channel, posting a status update might fail without any error feedback. As a temporary workaround, join the configured broadcast channels, or remove those channels from the run configuration.

Contributors#