v10 changelog#

Important

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

  • 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.1 - Feature Release#

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