diff --git a/docs/main/administration-guide/administration-guide-index.mdx b/docs/main/administration-guide/administration-guide-index.mdx
index 4523d8c35654..8f08ade4f927 100644
--- a/docs/main/administration-guide/administration-guide-index.mdx
+++ b/docs/main/administration-guide/administration-guide-index.mdx
@@ -6,11 +6,11 @@ Welcome to the Mattermost Administration Guide. This guide is organized into sec
Whether you’re configuring server settings, managing users, monitoring performance, or ensuring compliance, this guide provides all the information you need. Use the navigation below to access detailed instructions and best practices for each topic.
- [Self-hosted billing](/administration-guide/manage/admin/self-hosted-billing) - Billing and payment options for Mattermost self-hosted deployments.
-- [Cloud workspace management](/administration-guide/cloud-workspace-management) - Learn how to manage cloud workspaces in Mattermost.
+- [Cloud workspace management](/administration-guide/manage/cloud-workspace-management) - Learn how to manage cloud workspaces in Mattermost.
- [Server maintenance](/administration-guide/manage/admin/server-maintenance) - Learn about Mattermost server maintenance and best practices.
- [Server configuration](/administration-guide/manage/admin/server-configuration) - Learn about server configuration and settings.
- [User provisioning](/administration-guide/manage/admin/user-provisioning) - Learn about user provisioning and management.
- [User management](/administration-guide/manage/admin/user-management) - Learn about user management and best practices.
- [Monitoring and performance](/administration-guide/manage/admin/monitoring-and-performance) - Learn about monitoring and performance optimization.
-- [Compliance](/administration-guide/compliance-with-mattermost) - Learn about compliance and security best practices.
+- [Compliance](/administration-guide/comply/comply-index) - Learn about compliance and security best practices.
- [Migration](/administration-guide/manage/admin/migration) - Learn about migrating to Mattermost.
diff --git a/docs/main/administration-guide/compliance-with-mattermost.mdx b/docs/main/administration-guide/comply/comply-index.mdx
similarity index 98%
rename from docs/main/administration-guide/compliance-with-mattermost.mdx
rename to docs/main/administration-guide/comply/comply-index.mdx
index 348cc87e2f71..f12188746903 100644
--- a/docs/main/administration-guide/compliance-with-mattermost.mdx
+++ b/docs/main/administration-guide/comply/comply-index.mdx
@@ -1,5 +1,6 @@
---
title: "Compliance with Mattermost"
+sidebar_label: "Comply"
---
Mattermost is purpose-built to help enterprises keep sensitive data safe and compliant in the strictest, most complex environments. Mattermost Enterprise Edition includes features designed to make compliance with all relevant regulations and internal policies easy to achieve and maintain.
diff --git a/docs/main/administration-guide/configure/email-templates.mdx b/docs/main/administration-guide/configure/email-templates.mdx
index 24f6c4ab9dd2..7451f1d348a0 100644
--- a/docs/main/administration-guide/configure/email-templates.mdx
+++ b/docs/main/administration-guide/configure/email-templates.mdx
@@ -244,7 +244,8 @@ The email templates are located in the Mattermost server directory in the `templ
Button
-
Button for email verification | api.templates.verify_body.button
+
Button for email verification
+
api.templates.verify_body.button
diff --git a/docs/main/administration-guide/configure/experimental-configuration-settings.mdx b/docs/main/administration-guide/configure/experimental-configuration-settings.mdx
index a22429aa8f17..1cfbd3f8f367 100644
--- a/docs/main/administration-guide/configure/experimental-configuration-settings.mdx
+++ b/docs/main/administration-guide/configure/experimental-configuration-settings.mdx
@@ -13,10 +13,10 @@ Review and manage the following [experimental](/administration-guide/manage/feat
-System admins managing a self-hosted Mattermost deployment can edit the `config.json` file as described in the following tables. Each configuration value below includes a JSON path to access the value programmatically in the `config.json` file using a JSON-aware tool. For example, the `EmailBatchingBufferSize` value is under `EmailSettings`.
+System admins managing a self-hosted Mattermost deployment can edit the `config.json` file as described in the following tables. Each configuration value below includes a JSON path to access the value programmatically in the `config.json` file using a JSON-aware tool. For example, the `LinkMetadataTimeoutMilliseconds` value is under `ExperimentalSettings`.
-- If using a tool such as [jq](https://stedolan.github.io/jq/), you'd enter: `cat config/config.json | jq '.EmailSettings.EmailBatchingBufferSize'`
-- When working with the `config.json` file manually, look for an object such as `EmailSettings`, then within that object, find the key `EmailBatchingBufferSize`.
+- If using a tool such as [jq](https://stedolan.github.io/jq/), you'd enter: `cat config/config.json | jq '.ExperimentalSettings.LinkMetadataTimeoutMilliseconds'`
+- When working with the `config.json` file manually, look for an object such as `ExperimentalSettings`, then within that object, find the key `LinkMetadataTimeoutMilliseconds`.
@@ -56,51 +56,6 @@ Adds a configurable timeout for requests made to return link metadata. If the me
-### Email batching buffer size
-
-Specify the maximum number of notifications batched into a single email.
-
-
-
-- We recommend increasing the buffer size from the default value if you see the following error in the Mattermost logs: `Email batching job's receiving buffer was full. Please increase the EmailBatchingBufferSize. Falling back to sending immediate mail.` Increasing this value will ensure emails are queued up, without impacting server performance.
-- Notifications will be sent instantly if the queue of emails exceeds the [email batching interval](#email-batching-interval) configured.
-
-
-
-
-
-
-
-
-
-
This feature's config.json setting is EmailBatchingBufferSize: 256`` with numerical input.
-
-
-
-
-### Email batching interval
-
-Specify the maximum frequency, in seconds, which the batching job checks for new notifications.
-
-
-
-- We recommend decreasing the email batching interval from the default value if you see the following error in the Mattermost logs: `Email batching job's receiving buffer was full. Please increase the EmailBatchingBufferSize. Falling back to sending immediate mail.`.
-- Longer batching intervals may increase performance.
-- Notifications will be sent instantly if the [queue of emails](#email-batching-buffer-size) exceeds the email batching interval configured.
-
-
-
-
-
-
-
-
-
-
This feature's config.json setting is EmailBatchingInterval": 30 with numerical input.
-
-
-
-
### Enable automatic replies
**True**: Users can enable Automatic Replies in **Settings \> Notifications**. Users set a custom message that will be automatically sent in response to Direct Messages.
@@ -202,23 +157,6 @@ If the team URL of the primary team is `https://example.mattermost.com/myteam/`,
-### Use channel name in email notifications
-
-**True**: Channel and team name appears in email notification subject lines. Useful for servers using only one team.
-
-**False**: Only team name appears in email notification subject line.
-
-
-
-
-
-
-
-
This feature's config.json setting is "UseChannelInEmailNotifications": false with options true and false.
-
-
-
-
### Disable data refetching on browser refocus
This setting disables re-fetching of channel and channel members on browser focus.
diff --git a/docs/main/administration-guide/configure/install-boards.mdx b/docs/main/administration-guide/configure/install-boards.mdx
index d46f9d94442d..6e127cd7c7d5 100644
--- a/docs/main/administration-guide/configure/install-boards.mdx
+++ b/docs/main/administration-guide/configure/install-boards.mdx
@@ -37,4 +37,4 @@ See the [navigate boards](/end-user-guide/project-management/navigate-boards) do
## Work with boards
-See the [project and task management](/end-user-guide/project-task-management) end user documentation to learn how to align, define, organize, track, and manage work across teams.
+See the [project and task management](/end-user-guide/project-management/project-management-index) end user documentation to learn how to align, define, organize, track, and manage work across teams.
diff --git a/docs/main/administration-guide/configure/optimize-your-workspace.mdx b/docs/main/administration-guide/configure/optimize-your-workspace.mdx
index 51a254c9896c..6edb7ddfc667 100644
--- a/docs/main/administration-guide/configure/optimize-your-workspace.mdx
+++ b/docs/main/administration-guide/configure/optimize-your-workspace.mdx
@@ -31,37 +31,18 @@ The following optimization areas can alert you to workspace suggestions, warning
If your web server settings don't pass a live URL test, your workspace may not be accessible to others. | See the Web server configuration settings product documentation to learn more:
+
If your web server settings don't pass a live URL test, your workspace may not be accessible to others. See the Web server configuration settings product documentation to learn more.
Search performance
As your user base grows, is search getting slower?
diff --git a/docs/main/administration-guide/configure/site-configuration-settings.mdx b/docs/main/administration-guide/configure/site-configuration-settings.mdx
index e576861be1ca..18380f53e900 100644
--- a/docs/main/administration-guide/configure/site-configuration-settings.mdx
+++ b/docs/main/administration-guide/configure/site-configuration-settings.mdx
@@ -819,11 +819,13 @@ Access the following configuration settings in the System Console by going to **
-
+
+
-
This setting determines whether a user can open a direct message channel with anyone on the Mattermost server or only to members of the same team. This setting only affects the options presented in the user interface. It does not affect permissions on the backend server. | - System Config path: Site Configuration > Users and Teams |
- Any user on the Mattermost server: (Default) Users can send a direct message to any user through the Direct Messages > More menu. config.json setting: "any" | - Environment variable: MM_TEAMSETTINGS_RESTRICTDIRECTMESSAGE |
|
Any member of the team: The Direct Messages > More menu only allows direct messages to users on the same team. Pressing CtrlK on Windows or Linux, or ⌘K on Mac, only lists other users on the team currently being viewed. A user who is a member of multiple teams can only send direct messages to the team that is being viewed. However, the user can receive messages from other teams, regardless of the team currently being viewed. config.json setting: "team" |
+
This setting determines whether a user can open a direct message channel with anyone on the Mattermost server or only to members of the same team. This setting only affects the options presented in the user interface. It does not affect permissions on the backend server.
Any user on the Mattermost server: (Default) Users can send a direct message to any user through the Direct Messages > More menu. config.json setting: "any"
Any member of the team: The Direct Messages > More menu only allows direct messages to users on the same team. Pressing CtrlK on Windows or Linux, or ⌘K on Mac, only lists other users on the team currently being viewed. A user who is a member of multiple teams can only send direct messages to the team that is being viewed. However, the user can receive messages from other teams, regardless of the team currently being viewed. config.json setting: "team"
+
System Config path: Site Configuration > Users and Teams
@@ -832,11 +834,13 @@ Access the following configuration settings in the System Console by going to **
-
+
+
-
This setting determines how names appear in posts and under the Direct Messages list. | - System Config path: Site Configuration > Users and Teams | Users can change this setting in their interface under Settings > Display > | - ``config.json`` setting: ``TeamSettings`` > ``TeammateNameDisplay`` > ``username`` | Teammate Name Display, unless this setting is locked by a system admin | - Environment variable: MM_TEAMSETTINGS_TEAMMATENAMEDISPLAY | via the Lock teammate name display for all users configuration setting. | | | | - Show username: (Default for self-hosted deployments) Displays usernames. | | config.json option: "username". | | - Show nickname if one exists...: Displays the user's nickname. If the user doesn't have a | | nickname, their full name is displayed. If the user doesn't have a full name, their username | | is displayed. config.json option: "nickname_full_name". | | - Show first and last name: (Default for Cloud deployments) Displays user's full name. | | If the user doesn't have a full name, their username is displayed. Recommended when using | | SAML or | LDAP if first name and last name | attributes are configured. config.json option: "full_name". | |
+
This setting determines how names appear in posts and under the Direct Messages list. Users can change this setting in their interface under Settings > Display > Teammate Name Display, unless this setting is locked by a system admin via the Lock teammate name display for all users configuration setting.
Show username: (Default for self-hosted deployments) Displays usernames. config.json option: "username".
Show nickname if one exists...: Displays the user's nickname. If the user doesn't have a nickname, their full name is displayed. If the user doesn't have a full name, their username is displayed. config.json option: "nickname_full_name".
Show first and last name: (Default for Cloud deployments) Displays user's full name. If the user doesn't have a full name, their username is displayed. Recommended when using SAML or LDAP if first name and last name attributes are configured. config.json option: "full_name".
+
System Config path: Site Configuration > Users and Teams
+
+
+
+- Cloud admins can't modify this configuration setting.
+- This setting only applies when [email batching](#enable-email-batching) is enabled.
+- We recommend increasing the buffer size from the default value if you see the following error in the Mattermost logs: `Email batching job's receiving buffer was full. Please increase the EmailBatchingBufferSize. Falling back to sending immediate mail.` Increasing this value will ensure emails are queued up, without impacting server performance.
+- Notifications are sent immediately when the receiving buffer is full.
+
+
+
+### Email batching interval
+
+
+
+
+
+
+
+
+
Specify the maximum frequency, in seconds, which the batching job checks for new notifications.
Numerical input in seconds. Default is 30.
+
System Config path: Site Configuration > Notifications
+
+
+
+- Cloud admins can't modify this configuration setting.
+- This setting only applies when [email batching](#enable-email-batching) is enabled.
+- Longer batching intervals may increase performance.
+- Notifications are sent immediately when the receiving buffer is full. If that occurs, increase [Email batching buffer size](#email-batching-buffer-size).
+
+
+
### Email notification contents
@@ -1162,6 +1214,21 @@ Cloud admins can't modify this configuration setting.
+### Use channel name in email notifications
+
+
+
+
+
+
+
+
+
true: Channel and team name appears in email notification subject lines. Useful for servers using only one team.
false: (Default) Only team name appears in email notification subject line.
+
System Config path: Site Configuration > Notifications
diff --git a/docs/main/administration-guide/manage/admin/server-maintenance.mdx b/docs/main/administration-guide/manage/admin/server-maintenance.mdx
index eaafc2de050d..06cfc3073df1 100644
--- a/docs/main/administration-guide/manage/admin/server-maintenance.mdx
+++ b/docs/main/administration-guide/manage/admin/server-maintenance.mdx
@@ -8,7 +8,7 @@ Whether you’re installing a license key, performing backups, upgrading the ser
- [Install a license key](/administration-guide/manage/admin/installing-license-key) - Learn how to install a license key for Mattermost.
- [Generate a support packet](/administration-guide/manage/admin/generating-support-packet) - Learn how to generate a support packet for Mattermost.
- [Backup and disaster recovery](/deployment-guide/backup-disaster-recovery) - Learn about backup and disaster recovery for Mattermost.
-- [Upgrade Mattermost server](/administration-guide/upgrade-mattermost) - Learn how to upgrading Mattermost server.
+- [Upgrade Mattermost server](/administration-guide/upgrade/upgrade-index) - Learn how to upgrading Mattermost server.
- [Secure Mattermost](/security-guide/secure-mattermost) - Learn about securing Mattermost server.
- [Mattermost error codes](/administration-guide/manage/admin/error-codes) - Learn about Mattermost error codes and troubleshooting.
- [Logging](/administration-guide/manage/logging) - Learn how to customize logging options based on business practices and needs.
diff --git a/docs/main/administration-guide/cloud-workspace-management.mdx b/docs/main/administration-guide/manage/cloud-workspace-management.mdx
similarity index 100%
rename from docs/main/administration-guide/cloud-workspace-management.mdx
rename to docs/main/administration-guide/manage/cloud-workspace-management.mdx
diff --git a/docs/main/administration-guide/upgrade-mattermost.mdx b/docs/main/administration-guide/upgrade/upgrade-index.mdx
similarity index 98%
rename from docs/main/administration-guide/upgrade-mattermost.mdx
rename to docs/main/administration-guide/upgrade/upgrade-index.mdx
index a2db11c14c66..efcdf25863c7 100644
--- a/docs/main/administration-guide/upgrade-mattermost.mdx
+++ b/docs/main/administration-guide/upgrade/upgrade-index.mdx
@@ -1,5 +1,6 @@
---
title: "Upgrade Mattermost"
+sidebar_label: "Upgrade"
---
diff --git a/docs/main/deployment-guide/reference-architecture/deployment-scenarios/deploy-ddil-operations.mdx b/docs/main/deployment-guide/reference-architecture/deployment-scenarios/deploy-ddil-operations.mdx
index 6d22131d7bfc..ab0396b6ad78 100644
--- a/docs/main/deployment-guide/reference-architecture/deployment-scenarios/deploy-ddil-operations.mdx
+++ b/docs/main/deployment-guide/reference-architecture/deployment-scenarios/deploy-ddil-operations.mdx
@@ -38,9 +38,9 @@ This hybrid deployment architecture provides optimal collaboration in both conne
- **Mattermost Mobile Apps:** Access Mattermost via [iPhone and Android apps](/deployment-guide/mobile/mobile-app-deployment), with support for [ID-only push notifications](/deployment-guide/mobile/host-your-own-push-proxy-service) to ensure compliance with data sovereignty requirements. *(Optional when connectivity permits - not shown)*
- **Mattermost Deployment:** Mattermost deployed for sovereign tactical collaboration on local infrastructure, such as [Azure Local](https://learn.microsoft.com/en-us/azure/azure-local/manage/disconnected-operations-overview), supporting data residency regulations and [disconnected operations](/deployment-guide/reference-architecture/deployment-scenarios/air-gapped-deployment). See [reference architecture](/deployment-guide/reference-architecture/scale/server-architecture) documentation for Mattermost deployment configurations based on expected scale.
- **Mattermost Server:** Core application server handling tactical collaboration workloads, including:
- - [Messaging Collaboration](/end-user-guide/messaging-collaboration): DDIL-ready 1:1, group messaging, and structured channel collaboration with [rich integration capabilities](/integrations-guide/integrations-guide-index) and [enterprise-grade search](/deployment-guide/reference-architecture/scale/scaling-for-enterprise#enterprise-search).
- - [Workflow Automation](/end-user-guide/workflow-automation): Playbooks provide structure, monitoring and automation for repeatable processes built-in to your local Mattermost deployment.
- - [Project Tracking](/end-user-guide/project-task-management): Boards enables project management capabilities built-in to your local Mattermost deployment.
+ - [Messaging Collaboration](/end-user-guide/collaborate/collaborate-index): DDIL-ready 1:1, group messaging, and structured channel collaboration with [rich integration capabilities](/integrations-guide/integrations-guide-index) and [enterprise-grade search](/deployment-guide/reference-architecture/scale/scaling-for-enterprise#enterprise-search).
+ - [Workflow Automation](/end-user-guide/workflow-automation/workflow-automation-index): Playbooks provide structure, monitoring and automation for repeatable processes built-in to your local Mattermost deployment.
+ - [Project Tracking](/end-user-guide/project-management/project-management-index): Boards enables project management capabilities built-in to your local Mattermost deployment.
- [AI Agents](/administration-guide/configure/agents-admin-guide): AI Agents run against a local LLM hosted within your tactical network.
- [Audio & Screenshare](/deployment-guide/calls/calls-deployment-guide): Calls offers native real-time self-hosted audio calls and screen sharing within your tactical network.
- **Proxy Server:** The [proxy server](/deployment-guide/server/setup-nginx-proxy) handles HTTP(S) routing within the cluster, directing traffic between the server and clients accessing Mattermost services. NGINX is recommended for load balancing with support for WebSocket connections, health check endpoints, and sticky sessions. The proxy layer provides SSL termination and distributes client traffic across application servers.
diff --git a/docs/main/deployment-guide/reference-architecture/deployment-scenarios/deploy-mission-partner.mdx b/docs/main/deployment-guide/reference-architecture/deployment-scenarios/deploy-mission-partner.mdx
index 8a367455b5ed..a409aab506f5 100644
--- a/docs/main/deployment-guide/reference-architecture/deployment-scenarios/deploy-mission-partner.mdx
+++ b/docs/main/deployment-guide/reference-architecture/deployment-scenarios/deploy-mission-partner.mdx
@@ -54,9 +54,9 @@ The deployment architecture includes the following components:
- **Microsoft 365 Desktop Apps:** For partnered organizations using Microsoft 365 services, Teams and Outlook can be deployed with the [embedded Mattermost application](/integrations-guide/mattermost-mission-collaboration-for-m365) for cross-domain partner collaboration within a familiar interface. *(Optional)*
- **Mattermost Deployments:** Mattermost deployed for sovereign collaboration on private cloud or local infrastructure, such as [Azure](/deployment-guide/server/deploy-kubernetes) or [Azure Local](https://learn.microsoft.com/en-us/azure/azure-local/manage/disconnected-operations-overview), to maintain compliance with STIG, FedRAMP, and NIST 800-53 standards. See [reference architecture](/deployment-guide/reference-architecture/scale/server-architecture) documentation for Mattermost deployment configurations based on expected scale.
- **Mattermost Server:** Core application server handling collaboration workloads, including:
- - [Messaging Collaboration](/end-user-guide/messaging-collaboration): Sovereign 1:1, group messaging, and structured channel collaboration.
- - [Workflow Automation](/end-user-guide/workflow-automation): Playbooks provide structure, monitoring and automation for repeatable processes built-in to your sovereign Mattermost deployment.
- - [Project Tracking](/end-user-guide/project-task-management): Boards enables project management capabilities built-in to your local Mattermost deployment. Boards enables project management capabilities built-in to your sovereign Mattermost deployment.
+ - [Messaging Collaboration](/end-user-guide/collaborate/collaborate-index): Sovereign 1:1, group messaging, and structured channel collaboration.
+ - [Workflow Automation](/end-user-guide/workflow-automation/workflow-automation-index): Playbooks provide structure, monitoring and automation for repeatable processes built-in to your sovereign Mattermost deployment.
+ - [Project Tracking](/end-user-guide/project-management/project-management-index): Boards enables project management capabilities built-in to your local Mattermost deployment. Boards enables project management capabilities built-in to your sovereign Mattermost deployment.
- [AI Agents](/administration-guide/configure/agents-admin-guide): AI Agents run against Azure OpenAI endpoints or a self-hosted LLM that is OpenAI-compatible.
- [Audio & Screenshare](/deployment-guide/calls/calls-deployment-guide): Calls offers native real-time self-hosted audio calls and screen sharing within your own network.
- **Proxy Server:** The [proxy server](/deployment-guide/server/setup-nginx-proxy) handles HTTP(S) routing within the cluster, directing traffic between the server and clients accessing Mattermost services, including requests from users in [connected organizations](/administration-guide/onboard/connected-workspaces). NGINX is recommended for load balancing with support for WebSocket connections, health check endpoints, and sticky sessions. The proxy layer provides SSL termination and distributes client traffic across application servers.
diff --git a/docs/main/deployment-guide/reference-architecture/deployment-scenarios/deploy-sovereign-collaboration.mdx b/docs/main/deployment-guide/reference-architecture/deployment-scenarios/deploy-sovereign-collaboration.mdx
index 20a8673c25b7..03e6bf15e110 100644
--- a/docs/main/deployment-guide/reference-architecture/deployment-scenarios/deploy-sovereign-collaboration.mdx
+++ b/docs/main/deployment-guide/reference-architecture/deployment-scenarios/deploy-sovereign-collaboration.mdx
@@ -33,9 +33,9 @@ The deployment architecture includes the following components:
- **Mattermost Mobile Apps:** Access Mattermost via [iPhone and Android apps](/deployment-guide/mobile/mobile-app-deployment), with support for [ID-only push notifications](/deployment-guide/mobile/host-your-own-push-proxy-service) to ensure compliance with data sovereignty requirements. *(Optional - not shown)*
- **Mattermost Deployment:** Mattermost deployed for sovereign collaboration on enterprise-controlled infrastructure or private cloud, such as [Azure](/deployment-guide/server/deploy-kubernetes) or [Azure Local](https://learn.microsoft.com/en-us/azure/azure-local/manage/disconnected-operations-overview), to maintain compliance with STIG, FedRAMP, and NIST 800-53 standards. See [reference architecture](/deployment-guide/reference-architecture/scale/server-architecture) documentation for Mattermost deployment configurations based on expected scale.
- **Mattermost Server:** Core application server handling collaboration workloads, including:
- - [Messaging Collaboration](/end-user-guide/messaging-collaboration): DDIL-ready 1:1, group messaging, and structured channel collaboration with [rich integration capabilities](/integrations-guide/integrations-guide-index) and [enterprise-grade search](/deployment-guide/reference-architecture/scale/scaling-for-enterprise#enterprise-search).
- - [Workflow Automation](/end-user-guide/workflow-automation): Playbooks provide structure, monitoring and automation for repeatable processes built-in to your sovereign Mattermost deployment.
- - [Project Tracking](/end-user-guide/project-task-management): Boards enables project management capabilities built-in to your sovereign Mattermost deployment.
+ - [Messaging Collaboration](/end-user-guide/collaborate/collaborate-index): DDIL-ready 1:1, group messaging, and structured channel collaboration with [rich integration capabilities](/integrations-guide/integrations-guide-index) and [enterprise-grade search](/deployment-guide/reference-architecture/scale/scaling-for-enterprise#enterprise-search).
+ - [Workflow Automation](/end-user-guide/workflow-automation/workflow-automation-index): Playbooks provide structure, monitoring and automation for repeatable processes built-in to your sovereign Mattermost deployment.
+ - [Project Tracking](/end-user-guide/project-management/project-management-index): Boards enables project management capabilities built-in to your sovereign Mattermost deployment.
- [AI Agents](/administration-guide/configure/agents-admin-guide): AI Agents run against Azure OpenAI endpoints or a self-hosted LLM that is OpenAI-compatible.
- [Audio & Screenshare](/deployment-guide/calls/calls-deployment-guide): Calls offers native real-time self-hosted audio calls and screen sharing within your own network.
- **Proxy Server:** The [proxy server](/deployment-guide/server/setup-nginx-proxy) handles HTTP(S) routing within the cluster, directing traffic between the server and clients accessing Mattermost services. NGINX is recommended for load balancing with support for WebSocket connections, health check endpoints, and sticky sessions. The proxy layer provides SSL termination and distributes client traffic across application servers.
diff --git a/docs/main/deployment-guide/server/orchestration.mdx b/docs/main/deployment-guide/server/orchestration.mdx
index 77025c6144b8..f8f6b13dad55 100644
--- a/docs/main/deployment-guide/server/orchestration.mdx
+++ b/docs/main/deployment-guide/server/orchestration.mdx
@@ -1,6 +1,8 @@
---
title: "Deployment Solution Programs"
---
+import useBaseUrl from '@docusaurus/useBaseUrl';
+
Mattermost's **Deployment Solutions Programs** help IT administrators understand how Mattermost is being offered in third-party deployment solutions, including other open source projects as well as in commercial solutions.
This is an optional program for third-party developers to increase awareness about their work and to enable Mattermost to refer its communities to different solutions.
@@ -34,57 +36,33 @@ To summarize the commitment level of different solutions:
diff --git a/docs/main/end-user-guide/access/client-availability.mdx b/docs/main/end-user-guide/access/client-availability.mdx
index 27d58ec65994..784917e5f35e 100644
--- a/docs/main/end-user-guide/access/client-availability.mdx
+++ b/docs/main/end-user-guide/access/client-availability.mdx
@@ -9,422 +9,534 @@ The following tables highlight the end user features of Mattermost and their sup
## Messages
-
@@ -195,7 +196,31 @@ Renders as:
Creating a fixed-width code block is recommended for pasting multi-line blocks of code or other text output because it's easier to read with fixed-width font alignment. Examples include block text snippets, ASCII tables, and log files. Rendered code blocks include a **Copy** option to copy the contents of the code block.
-This can be accomplished by placing three backticks ```` ` on the line directly above and directly below your code: .. code-block:: text `` this is my code block `.. tip:: Type three backticks```, press \`Shift \\_\_ Enter on Windows or Linux, or ⇧↵ on Mac, ``, press ShiftEnter on Windows or Linux, or ⇧↵ on Mac again, then type three more backticks ```` `. Or by indenting each line by four spaces: .. code-block:: text this is my code block ^^^^ 4x spaces Syntax highlighting ^^^^^^^^^^^^^^^^^^^^ To add syntax highlighting, type the language to be highlighted after the ````\` at the beginning of the code block. Mattermost also offers four different code themes (GitHub, Solarized Dark, Solarized Light, and Monokai) that can be changed in **Settings \> Display \> Theme \> Custom Theme \> Center Channel Styles**.
+This can be accomplished by placing three backticks (```` ``` ````) on the line directly above and directly below your code:
+
+````text
+```
+this is my
+code block
+```
+````
+
+
+
+Type three backticks (```` ``` ````), press ShiftEnter on Windows or Linux, or ⇧↵ on Mac, ``, press ShiftEnter on Windows or Linux, or ⇧↵ on Mac again, then type three more backticks (```` ``` ````).
+
+
+
+Or by indenting each line by four spaces:
+
+```text
+ this is my
+ code block
+```
+
+### Syntax highlighting
+
+To add syntax highlighting, type the language to be highlighted after the ```` ``` ```` at the beginning of the code block. Mattermost also offers four different code themes (GitHub, Solarized Dark, Solarized Light, and Monokai) that can be changed in **Settings \> Display \> Theme \> Custom Theme \> Center Channel Styles**.
Supported languages and their aliases include:
diff --git a/docs/main/end-user-guide/collaborate/keyboard-accessibility.mdx b/docs/main/end-user-guide/collaborate/keyboard-accessibility.mdx
index 520caa912cba..c86673e3fc78 100644
--- a/docs/main/end-user-guide/collaborate/keyboard-accessibility.mdx
+++ b/docs/main/end-user-guide/collaborate/keyboard-accessibility.mdx
@@ -7,26 +7,39 @@ Navigational keyboard shortcuts help you use Mattermost in a web browser or the
-
+
+
+
+
+
Keyboard shortcut
+
Description
+
+
-
Keyboard shortcut | Description |
==============================================+==================================================================================+ | Desktop App: F6 || Move focus to the next section | | Browser: CtrlF6 || |
+
Desktop App: F6 Browser: CtrlF6
+
Move focus to the next section
-
Desktop App: ShiftF6 || Move focus to the previous section | Browser: CtrlShiftF6 |
diff --git a/docs/main/end-user-guide/collaborate/keyboard-shortcuts.mdx b/docs/main/end-user-guide/collaborate/keyboard-shortcuts.mdx
index 6089ab0daad3..936188143493 100644
--- a/docs/main/end-user-guide/collaborate/keyboard-shortcuts.mdx
+++ b/docs/main/end-user-guide/collaborate/keyboard-shortcuts.mdx
@@ -22,67 +22,88 @@ Mattermost keyboard shortcuts help you make a more efficient use of your keyboar
The following keyboard shortcuts for channels are supported in all [supported browsers](/deployment-guide/software-hardware-requirements#software-requirements) and in the Mattermost desktop app.
CtrlShiftL | ⌘⇧L | Set focus to center channel input field.
+
CtrlShiftL
+
⌘⇧L
+
Set focus to center channel input field.
-
Ctrl. | ⌘. | Open or close the right-hand sidebar. |
+
Ctrl.
+
⌘.
+
Open or close the right-hand sidebar.
-
CtrlShift. | ⌘⇧. | Expand or shrink the width of the open right-hand sidebar.
+
CtrlShift.
+
⌘⇧.
+
Expand or shrink the width of the open right-hand sidebar.
-
CtrlShiftF | ⌘⇧F | Move focus to the Search field and search the current channel.
+
CtrlShiftF
+
⌘⇧F
+
Move focus to the Search field and search the current channel.
-
CtrlShiftU | ⌘⇧U | Find unread channels or search through all channels.
+
CtrlShiftU
+
⌘⇧U
+
Find unread channels or search through all channels.
-
CtrlShiftI | ⌘⇧I | Open or close Channel Info details in the right-hand sidebar.
+
CtrlShiftI
+
⌘⇧I
+
Open or close Channel Info details in the right-hand sidebar.
@@ -91,21 +112,19 @@ The following keyboard shortcuts for channels are supported in all [supported br
The following keyboard shortcuts are supported in all [supported browsers](/deployment-guide/software-hardware-requirements#software-requirements) and in the Mattermost desktop app.
-
@@ -115,41 +134,53 @@ The following keyboard shortcuts are supported in all [supported browsers](/depl
The following keyboard shortcuts are supported in all [supported browsers](/deployment-guide/software-hardware-requirements#software-requirements) and in the Mattermost desktop app.
CtrlShift\ | ⌘⇧\ | React to last message in channel or thread.
+
CtrlShift\
+
⌘⇧\
+
React to last message in channel or thread.
@@ -159,26 +190,28 @@ The following keyboard shortcuts are supported in all [supported browsers](/depl
The following keyboard shortcuts are supported in all [supported browsers](/deployment-guide/software-hardware-requirements#software-requirements) and in the Mattermost desktop app.
@@ -188,32 +221,38 @@ The following keyboard shortcuts are supported in all [supported browsers](/depl
The following keyboard shortcuts work in all [supported browsers](/deployment-guide/software-hardware-requirements#software-requirements) and in the Mattermost desktop app.
Alt← | ⌘[ | Go to the previous channel in your history.
-
-
+
Alt←
+
⌘[
+
Go to the previous channel in your history.
-
Alt→ | ⌘] | Go to the next channel in your history.
+
Alt→
+
⌘]
+
Go to the next channel in your history.
-
Shift↑ (in input field) | ⇧↑ (in input field) | Highlight text to the previous line.
+
Shift↑ (in input field)
+
⇧↑ (in input field)
+
Highlight text to the previous line.
-
Shift↓ (in input field) | ⇧↓ (in input field) | Highlight text to the next line.
+
Shift↓ (in input field)
+
⇧↓ (in input field)
+
Highlight text to the next line.
-
ShiftEnter (in input field) | ⇧Enter (in input field) | Create a new line.
+
ShiftEnter (in input field)
+
⇧Enter (in input field)
+
Create a new line.
@@ -229,38 +268,48 @@ Though Mattermost keyboard shortcuts support standard languages and keyboard lay
The following keyboard shortcuts are supported in all [supported browsers](/deployment-guide/software-hardware-requirements#software-requirements) and in the Mattermost desktop app when [calls](/end-user-guide/collaborate/make-calls) are enabled.
Space | Space | Hold to unmute (push to talk) Note: works in the expanded view/popout window only. |
+
Space
+
Space
+
Hold to unmute (push to talk) Note: works in the expanded view/popout window only.
@@ -275,38 +324,48 @@ The following navigation keyboard shortcuts are supported only in the Mattermost
Mattermost desktop app v6.0 introduces the ability to keep multiple workspaces open at the same time and work across them without constant switching contexts. The following keyboard shortcuts help you navigate multiple views:
@@ -317,47 +376,53 @@ Mattermost desktop app v6.0 introduces the ability to keep multiple workspaces o
Mattermost desktop app v5.0 introduces additional ways to navigate your Mattermost interface, including server selections, as well as tabs for channels, collaborative playbooks, and boards.
CtrlF | ⌘F | Move focus to the Search field and search the current channel. |
-
-
+
CtrlF
+
⌘F
+
Move focus to the Search field and search the current channel.
-
-
CtrlShiftS | ⌘⌃S | Open the Servers selector, press ↑ or ↓ to navigate between
-
-
| servers, then press Enter on Windows or Linux, or ↵ on macOS, to select a server. |
-
-
+
CtrlShiftS
+
⌘⌃S
+
Open the Servers selector, press ↑ or ↓ to navigate between servers, then press Enter on Windows or Linux, or ↵ on macOS, to select a server.
-
CtrlShift1 || ⌘⌃1 || Navigate to the first server in the Servers list. |
-CtrlShift2 || ⌘⌃2 || Replace the number with the server's position within the server in the list. |
+
CtrlShift1 CtrlShift2
+
⌘⌃1 ⌘⌃2
+
Navigate to the first server in the Servers list. Replace the number with the server's position within the server in the list.
-
CtrlTab | ⌘Tab | Navigate to the next product tab based on the current product selected. |
+
CtrlTab
+
⌘Tab
+
Navigate to the next product tab based on the current product selected.
-
CtrlShiftTab | ⌘⇧Tab | Navigate to the previous product tab based on the current product selected. |
+
CtrlShiftTab
+
⌘⇧Tab
+
Navigate to the previous product tab based on the current product selected.
@@ -368,34 +433,38 @@ Mattermost desktop app v5.0 introduces additional ways to navigate your Mattermo
Mattermost desktop app v4.7 and earlier releases support the following navigation keyboard shortcuts:
CtrlF | ⌘F | Move focus to the Search field and search the current channel. |
-
-
+
CtrlF
+
⌘F
+
Move focus to the Search field and search the current channel.
-
Ctrl1 || ⌘1 | Navigate to the first server in the Servers list. |
-Ctrl2 || ⌘2 | Replace the number with the server's tab position. |
-Ctrl3 || ⌘3 | |
+
Ctrl1 Ctrl2 Ctrl3
+
⌘1 ⌘2 ⌘3
+
Navigate to the first server in the Servers list. Replace the number with the server's tab position.
-
CtrlTab | ⌘Tab | Navigate to the next server tab based on the current server selected. |
+
CtrlTab
+
⌘Tab
+
Navigate to the next server tab based on the current server selected.
-
CtrlShiftTab | ⌘⇧Tab | Navigate to the previous server tab based on the current server selected.
+
CtrlShiftTab
+
⌘⇧Tab
+
Navigate to the previous server tab based on the current server selected.
-
Alt↓ | ⌥↓ | Next channel or direct message in the channel sidebar. |
+
Alt↓
+
⌥↓
+
Next channel or direct message in the channel sidebar.
@@ -409,23 +478,23 @@ Mattermost desktop app v4.7 and earlier releases support the following navigatio
The following display keyboard shortcuts work in all [supported browsers](/deployment-guide/software-hardware-requirements#software-requirements) and in the Mattermost desktop app.
diff --git a/docs/main/end-user-guide/collaborate/team-keyboard-shortcuts.mdx b/docs/main/end-user-guide/collaborate/team-keyboard-shortcuts.mdx
index b11b4dfb4636..71770d12aaa3 100644
--- a/docs/main/end-user-guide/collaborate/team-keyboard-shortcuts.mdx
+++ b/docs/main/end-user-guide/collaborate/team-keyboard-shortcuts.mdx
@@ -19,23 +19,28 @@ The following keyboard shortcuts are supported in all [supported browsers](/depl
diff --git a/docs/main/end-user-guide/end-user-guide-index.mdx b/docs/main/end-user-guide/end-user-guide-index.mdx
index 01f80812f1a4..91c16137e31a 100644
--- a/docs/main/end-user-guide/end-user-guide-index.mdx
+++ b/docs/main/end-user-guide/end-user-guide-index.mdx
@@ -6,12 +6,12 @@ If you're using Mattermost to connect and collaborate, build repeatable, automat
In this documentation, you'll learn about using Mattermost. Your Mattermost system admin has deployed Mattermost for your organization. A live Mattermost instance is ready for you to log into using your user credentials. Your Mattermost workspace is where you'll send and receive messages, see activity notifications, create, run, and participate in playbook runs, and where you'll customize look and feel through workspace preferences.
- [Access Your Workspace](/end-user-guide/access/access-your-workspace) - Learn how to access Mattermost using web, desktop, or mobile apps, and authenticate with your credentials.
-- [Messaging Collaboration](/end-user-guide/messaging-collaboration) - Learn how to use Mattermost to connect and collaborate with your teammates.
-- [Workflow Automation](/end-user-guide/workflow-automation) - Learn how to use Mattermost Playbooks to build repeatable processes, move faster, and make fewer mistakes with checklist-based automations.
+- [Messaging Collaboration](/end-user-guide/collaborate/collaborate-index) - Learn how to use Mattermost to connect and collaborate with your teammates.
+- [Workflow Automation](/end-user-guide/workflow-automation/workflow-automation-index) - Learn how to use Mattermost Playbooks to build repeatable processes, move faster, and make fewer mistakes with checklist-based automations.
- [Audio and Screensharing](/end-user-guide/collaborate/audio-and-screensharing) - Learn about Mattermost's self-hosted audio calls plugin with screen sharing and the many video conferencing integrations Mattermost supports.
-- [Project and Task Management](/end-user-guide/project-task-management) - Learn how to use Mattermost Boards to coordinate operational work with Kanban-style planning.
-- [AI Agents](/end-user-guide/agents) - Learn how to use AI agents to help you make decisions, find information, and automate repetative tasks.
-- [Customize Your Preferences](/end-user-guide/preferences) - Learn how to make Mattermost match the way you prefer to work.
+- [Project and Task Management](/end-user-guide/project-management/project-management-index) - Learn how to use Mattermost Boards to coordinate operational work with Kanban-style planning.
+- [AI Agents](/end-user-guide/agents) - Learn how to use AI agents to help you make decisions, find information, and automate repetitive tasks.
+- [Customize Your Preferences](/end-user-guide/preferences/preferences-index) - Learn how to make Mattermost match the way you prefer to work.
diff --git a/docs/main/end-user-guide/preferences/manage-your-profile.mdx b/docs/main/end-user-guide/preferences/manage-your-profile.mdx
index 07fdea74a132..ccf706238105 100644
--- a/docs/main/end-user-guide/preferences/manage-your-profile.mdx
+++ b/docs/main/end-user-guide/preferences/manage-your-profile.mdx
@@ -11,42 +11,39 @@ Your system admin may also manage profile fields for accounts that sign in with
Your name appears in the direct messages member list and team management modal. By default, you'll receive mention notifications when someone types your first name in a message.
-
+
Profile setting
+
Description
+
+
-
+
Full, first, and last name
+
Your name appears in the direct messages member list and team management modal. By default, you'll receive mention notifications when someone types your first name in a message.
Username
Usernames are unique identifiers appearing next to all posts. Usernames must begin with a letter, and contain between 3 to 22 lowercase characters made up of numbers, letters, and the symbols ., -, and _.
Pick something easy for teammates to recognize and recall. By default, you'll receive mention notifications when someone types your username. Changing your username won't change your existing @mentions in sent messages.
-
Nickname
-
(Optional) Nicknames appear in the direct messages member list and team management modal. | Your nickname can be up to 64 characters long. | | You won't be notified when someone types your nickname unless you add your nickname to the list | of Keywords that Trigger Notifications as a notification preference |. | From Mattermost v10.8, nicknames display in | threaded discussions when available. |
+
(Optional) Nicknames appear in the direct messages member list and team management modal. Your nickname can be up to 64 characters long.
You won't be notified when someone types your nickname unless you add your nickname to the list of Keywords that Trigger Notifications as a notification preference.
From Mattermost v10.8, nicknames display in threaded discussions when available.
Position
(Optional) Position can be used to describe your role or job title. Your position appears in the profile popup that displays when you select a user's name in the center channel or right-hand sidebar.
-
Email
Email is used for signing in, notifications, and password reset.
-
Profile picture
Profile pictures appear next to all posts, and you can select your profile picture to access your profile settings. To change your profile picture:
Using the web or the desktop app
Select Edit next to the Profile Picture option.
Choose Select, pick the profile image you want to use, and select Save.
Using the mobile app
Tap your current profile picture.
Take a photo using your device, or select an image to use.
For best results, choose an image that's at least 128 x 128 pixels in size. Supported image formats include: BMP, JPG, JPEG, and PNG. GIF isn't supported.
-
diff --git a/docs/main/end-user-guide/preferences.mdx b/docs/main/end-user-guide/preferences/preferences-index.mdx
similarity index 98%
rename from docs/main/end-user-guide/preferences.mdx
rename to docs/main/end-user-guide/preferences/preferences-index.mdx
index 6620bee194e8..22441249a935 100644
--- a/docs/main/end-user-guide/preferences.mdx
+++ b/docs/main/end-user-guide/preferences/preferences-index.mdx
@@ -1,5 +1,6 @@
---
title: "Customize your preferences"
+sidebar_label: "Preferences"
---
diff --git a/docs/main/end-user-guide/preferences/set-your-status-availability.mdx b/docs/main/end-user-guide/preferences/set-your-status-availability.mdx
index ce0a0cc2a6d1..4fe8f717517a 100644
--- a/docs/main/end-user-guide/preferences/set-your-status-availability.mdx
+++ b/docs/main/end-user-guide/preferences/set-your-status-availability.mdx
@@ -3,6 +3,7 @@ title: "Set your status and availability"
---
import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';
+import useBaseUrl from '@docusaurus/useBaseUrl';
@@ -50,20 +51,54 @@ To set your availability, select your profile picture, then specify your availab
| - Set automatically for you when you're active on Mattermost using a browser, the desktop app, or the mobile app. | - When using the desktop app, any mouse or keyboard activity keeps your availability set to Online. | - By default, notifications are sent to the browser, the desktop app, and the mobile app. |
+
Online
+
+
+- Set automatically for you when you're active on Mattermost using a browser, the desktop app, or the mobile app.
+- When using the desktop app, any mouse or keyboard activity keeps your availability set to **Online**.
+- By default, notifications are sent to the browser, the desktop app, and the mobile app.
+
+
| - Set automatically for you when you've been inactive for more than 5 minutes. System admins can change this | value using an experimental configuation setting called | `user status away timeout <mm-ref:administration-guide%2Fconfigure%2Fexperimental-configuration-settings%3Auser%20status%20away%20timeout>`\_\_. | | - You're inactive in Mattermost when you're not: typing in or navigating between channels, switching to | another browser tab, or when you've minimized or moved the browser window to the background. | | - You can manually set yourself as Away any time. | - By default, notifications are sent to your Mattermost mobile app. |
+
Away
+
+
+- Set automatically for you when you've been inactive for more than 5 minutes. System admins can change this value using an experimental configuration setting called `user status away timeout`.
+- You're inactive in Mattermost when you're not: typing in or navigating between channels, switching to another browser tab, or when you've minimized or moved the browser window to the background.
+- You can manually set yourself as **Away** any time.
+- By default, notifications are sent to your Mattermost mobile app.
+
+
| - Set automatically for you when you exit the Mattermost desktop app or close the browser window, sleep or | lock your computer, or on mobile when you change apps, close the Mattermost mobile app, or lock your | mobile device screen. | - You can manually set yourself as Offline any time. | - By default, notifications are sent to your Mattermost mobile app. |
+
Offline
+
+
+- Set automatically for you when you exit the Mattermost desktop app or close the browser window, sleep or lock your computer, or on mobile when you change apps, close the Mattermost mobile app, or lock your mobile device screen.
+- You can manually set yourself as **Offline** any time.
+- By default, notifications are sent to your Mattermost mobile app.
+
+
diff --git a/docs/main/end-user-guide/project-task-management.mdx b/docs/main/end-user-guide/project-management/project-management-index.mdx
similarity index 98%
rename from docs/main/end-user-guide/project-task-management.mdx
rename to docs/main/end-user-guide/project-management/project-management-index.mdx
index 5800517304ad..40b1e7d8ee98 100644
--- a/docs/main/end-user-guide/project-task-management.mdx
+++ b/docs/main/end-user-guide/project-management/project-management-index.mdx
@@ -1,5 +1,6 @@
---
title: "Project and Task Management"
+sidebar_label: "Project Management"
---
diff --git a/docs/main/end-user-guide/project-management/share-and-collaborate.mdx b/docs/main/end-user-guide/project-management/share-and-collaborate.mdx
index 22ff856dea5c..a8a39c55364f 100644
--- a/docs/main/end-user-guide/project-management/share-and-collaborate.mdx
+++ b/docs/main/end-user-guide/project-management/share-and-collaborate.mdx
@@ -1,6 +1,8 @@
---
title: "Share and collaborate"
---
+import useBaseUrl from '@docusaurus/useBaseUrl';
+
## Board permissions
@@ -13,47 +15,84 @@ If your boards workspace looks different, you may be on an earlier version of bo
diff --git a/docs/main/end-user-guide/workflow-automation/interact-with-playbooks.mdx b/docs/main/end-user-guide/workflow-automation/interact-with-playbooks.mdx
index edb945073d2d..a67239e90ddb 100644
--- a/docs/main/end-user-guide/workflow-automation/interact-with-playbooks.mdx
+++ b/docs/main/end-user-guide/workflow-automation/interact-with-playbooks.mdx
@@ -24,7 +24,7 @@ Available slash commands include:
## Playbooks on the go
-Learn how to [access and work with playbooks on the go](https://docs.mattermost.com/end-user-guide/workflow-automation.html#itab--Mobile--0_1-Mobile) with the Mattermost mobile app.
+Learn how to [access and work with playbooks on the go](/end-user-guide/workflow-automation/work-with-runs#playbook-runs-on-mobile) with the Mattermost mobile app.
## API documentation
diff --git a/docs/main/end-user-guide/workflow-automation.mdx b/docs/main/end-user-guide/workflow-automation/workflow-automation-index.mdx
similarity index 100%
rename from docs/main/end-user-guide/workflow-automation.mdx
rename to docs/main/end-user-guide/workflow-automation/workflow-automation-index.mdx
diff --git a/docs/main/for/end-user.mdx b/docs/main/for/end-user.mdx
index 4b80d66dfaf4..0e921e39ce83 100644
--- a/docs/main/for/end-user.mdx
+++ b/docs/main/for/end-user.mdx
@@ -25,8 +25,8 @@ You use Mattermost day-to-day to message, collaborate, and get work done. This p
{title: 'Send and format messages', to: '/end-user-guide/collaborate/send-messages', description: 'Markdown, code blocks, mentions, attachments.'},
{title: 'Organize with threads', to: '/end-user-guide/collaborate/organize-conversations', description: 'Keep parallel conversations untangled.'},
{title: 'Calls and screen sharing', to: '/end-user-guide/collaborate/audio-and-screensharing', description: 'Audio, screen share, transcription.'},
- {title: 'Playbooks', to: '/end-user-guide/workflow-automation', description: 'Checklists, runs, retrospectives.'},
- {title: 'Boards', to: '/end-user-guide/project-task-management', description: 'Kanban tasks linked to channels.'},
+ {title: 'Playbooks', to: '/end-user-guide/workflow-automation/workflow-automation-index', description: 'Checklists, runs, retrospectives.'},
+ {title: 'Boards', to: '/end-user-guide/project-management/project-management-index', description: 'Kanban tasks linked to channels.'},
{title: 'Keyboard shortcuts', to: '/end-user-guide/collaborate/keyboard-shortcuts', description: 'Move at the speed of muscle memory.'},
]} />
diff --git a/docs/main/for/sre.mdx b/docs/main/for/sre.mdx
index 8d0ea1344f83..50f86ddb7ed3 100644
--- a/docs/main/for/sre.mdx
+++ b/docs/main/for/sre.mdx
@@ -14,7 +14,7 @@ You own Mattermost's deployment, scaling, and operations. This page is a curated
## Start here
diff --git a/docs/main/index.mdx b/docs/main/index.mdx
index a6e82f2690c7..387755183746 100644
--- a/docs/main/index.mdx
+++ b/docs/main/index.mdx
@@ -48,7 +48,7 @@ Built on an extensible open-core architecture, Mattermost offers an array of col
### Messaging collaboration
-[Mattermost Channels](/end-user-guide/messaging-collaboration) enables secure, real-time and asynchronous communication across web, desktop, and mobile—powering mission-critical collaboration and Chat Operations (ChatOps) workflows across connected, hybrid, and air-gapped environments. Channels feature the following capabilities:
+[Mattermost Channels](/end-user-guide/collaborate/collaborate-index) enables secure, real-time and asynchronous communication across web, desktop, and mobile—powering mission-critical collaboration and Chat Operations (ChatOps) workflows across connected, hybrid, and air-gapped environments. Channels feature the following capabilities:
- [Public](/end-user-guide/collaborate/channel-types#public-channels) and [private](/end-user-guide/collaborate/channel-types#private-channels) channels, [direct messages](/end-user-guide/collaborate/channel-types#direct-message-channels), and [threaded conversations](/end-user-guide/collaborate/organize-conversations) for structured operational coordination.
- [Role-based access controls](/end-user-guide/collaborate/learn-about-roles) and [audit logs](/administration-guide/manage/logging#audit-logging) to support need-to-know enforcement.
@@ -63,7 +63,7 @@ See the [Client availability](/end-user-guide/access/client-availability) docume
### Workflow automation
-[Mattermost Playbooks](/end-user-guide/workflow-automation) standardizes and automates mission workflows such as incident response, shift changeovers, and operational checklists—reducing human error and improving procedural consistency. Playbooks feature:
+[Mattermost Playbooks](/end-user-guide/workflow-automation/workflow-automation-index) standardizes and automates mission workflows such as incident response, shift changeovers, and operational checklists—reducing human error and improving procedural consistency. Playbooks feature:
- Structured [checklists](/end-user-guide/workflow-automation/work-with-playbooks#make-checklists) with assigned [tasks and due dates](/end-user-guide/workflow-automation/work-with-tasks#tasks-and-due-dates) to operationalize standard and incident or emergency operating procedures.
- Automated [status updates and real-time notifications](/end-user-guide/workflow-automation/notifications-and-updates) in linked channels to keep stakeholders informed of workflow progress or blockers.
@@ -87,7 +87,7 @@ See the [Client availability](/end-user-guide/access/client-availability) docume
### Project and task management
-[Mattermost Boards](/end-user-guide/project-task-management) enables you to coordinate operational work with Kanban-style planning that integrates directly into messaging workflows—enabling transparency, prioritization, and accountability across teams with the following capabilities:
+[Mattermost Boards](/end-user-guide/project-management/project-management-index) enables you to coordinate operational work with Kanban-style planning that integrates directly into messaging workflows—enabling transparency, prioritization, and accountability across teams with the following capabilities:
- Provides visual task [boards](/end-user-guide/project-management/work-with-boards) with drag-and-drop [cards](/end-user-guide/project-management/work-with-cards) and customizable workflows, supporting contextual awareness and [role-based task visibility](/end-user-guide/project-management/share-and-collaborate#board-permissions).
- Delivers real-time updates and synchronization with [linked Mattermost channels](/end-user-guide/project-management/navigate-boards#link-a-board-to-a-channel).
diff --git a/docs/main/integrations-guide/integrations-guide-index.mdx b/docs/main/integrations-guide/integrations-guide-index.mdx
index dafe882c753e..8d30d1e141bb 100644
--- a/docs/main/integrations-guide/integrations-guide-index.mdx
+++ b/docs/main/integrations-guide/integrations-guide-index.mdx
@@ -139,9 +139,9 @@ Learn more about additional [no-code automation options](/integrations-guide/no-
### Mattermost Playbooks
-[Mattermost Playbooks](/end-user-guide/workflow-automation) lets you define and execute repeatable processes without any coding. Playbooks are often used for incident response, onboarding checklists, or any workflow that involves multiple steps, owners, and notifications. Playbooks have integration points you can use to trigger actions, and they can work in conjunction with plugins, making them a powerful no-code automation tool for orchestrating both human and system actions.
+[Mattermost Playbooks](/end-user-guide/workflow-automation/workflow-automation-index) lets you define and execute repeatable processes without any coding. Playbooks are often used for incident response, onboarding checklists, or any workflow that involves multiple steps, owners, and notifications. Playbooks have integration points you can use to trigger actions, and they can work in conjunction with plugins, making them a powerful no-code automation tool for orchestrating both human and system actions.
-Learn more about using [Playbooks](/end-user-guide/workflow-automation).
+Learn more about using [Playbooks](/end-user-guide/workflow-automation/workflow-automation-index).
## Frequently Asked Questions
diff --git a/docs/main/integrations-guide/popular-integrations.mdx b/docs/main/integrations-guide/popular-integrations.mdx
index 5680180b5c90..a6e71c5b42c0 100644
--- a/docs/main/integrations-guide/popular-integrations.mdx
+++ b/docs/main/integrations-guide/popular-integrations.mdx
@@ -1,119 +1,43 @@
---
title: "Popular Pre-Built Integrations"
---
+import useBaseUrl from '@docusaurus/useBaseUrl';
+
Accelerate your operational and technical workflows by connecting Mattermost with your mission-critical tools through pre-built integrations.
## Mattermost Integrations
Designed for teams that need reliability, auditability, and ownership of their collaboration stack, the following Mattermost collaboration integrations keep your data all inside your secure Mattermost ecosystem. Reduce tool sprawl, strengthen security, improve compliance posture, all with a seamless user experience.
-
-
-
-
-
-
-
-
Mattermost Integration | How to Get It | What It Does |
+| Mattermost Integration | How to Get It | What It Does |
+| --- | --- | --- |
+| [Mattermost Channel Export](/administration-guide/comply/export-mattermost-channel-data) | > **App Marketplace** | Exports channel history and data for compliance purposes. |
+| [Mattermost Legal Hold](/administration-guide/comply/legal-hold) | Manual Upload | Keeps a copy of messages and files so they cannot be deleted for legal or compliance needs. |
+| [Mattermost Metrics](/administration-guide/scale/collect-performance-metrics) | > **App Marketplace** | Shows numbers about system performance when people use Mattermost. |
+| [Mattermost User Survey](/administration-guide/configure/manage-user-surveys) | > **App Marketplace** | Collects feedback by asking questions directly in Mattermost channels. |
## Microsoft Integrations
If your organization relies on Microsoft tools, Mattermost offers deep integrations with M365, Teams, Outlook, and Calendar to keep collaboration seamless and secure. These integrations allow you to enhance and extend Microsoft tools while maintaining Mattermost as your central hub. By connecting Mattermost with Microsoft apps, you reduce context switching, strengthen reliability through secure fallback options, and ensure your workflows stay efficient across both platforms.
-
-
-
-
-
-
-
-
Microsoft Integration | Where to Get It | What It Does |
Microsoft Teams Sync | product-list > App Marketplace | Copies messages from Microsoft Teams into Mattermost (one-way) to keep conversations in sync.
-
-
-
+| Microsoft Integration | Where to Get It | What It Does |
+| --- | --- | --- |
+| [Mattermost Embedded for M365, Teams, and Outlook](/integrations-guide/mattermost-mission-collaboration-for-m365) | Manual Upload | Embed Mattermost in Microsoft apps. Use Outlook and Teams together with Mattermost for secure backup and extra features. |
+| [Microsoft Calendar](/integrations-guide/microsoft-calendar) | > **App Marketplace** | Sends your Microsoft Calendar reminders into Mattermost so you don't miss events. |
+| [Microsoft Teams Meetings](/integrations-guide/microsoft-teams-meetings) | > **App Marketplace** | Lets you start or join Microsoft Teams meetings directly from Mattermost. |
+| [Microsoft Teams Sync](/integrations-guide/microsoft-teams-sync) | > **App Marketplace** | Copies messages from Microsoft Teams into Mattermost (one-way) to keep conversations in sync. |
The following integrations bring key external tools (DevOps, ITSM, monitoring, and meetings) into Mattermost, so teams can see updates, take action, and collaborate faster without leaving their secure chat environment.
-
-
-
-
-
-
-
-
-
-
-
Third-Party Integration | Where to Get It | What It Does |
Sends Splunk alerts and search results directly into Mattermost channels.
-
-
-
-
Zoom | product-list > App Marketplace | Lets you start and join Zoom meetings from inside Mattermost.
-
-
-
+| Third-Party Integration | Where to Get It | What It Does |
+| --- | --- | --- |
+| [GitHub](/integrations-guide/github) | > **App Marketplace** | Shows GitHub updates, like new pull requests, commits, or issues, in Mattermost channels. |
+| [GitLab](/integrations-guide/gitlab) | > **App Marketplace** | Sends GitLab activity (code pushes, merge requests, CI/CD pipeline updates) into Mattermost channels. |
+| [Jira](/integrations-guide/jira) | > **App Marketplace** | Lets you see, create, and update Jira issues inside Mattermost. |
+| [Pexip](https://mattermost.com/marketplace/pexip-video-connect/) | [Mattermost Marketplace](https://mattermost.com/marketplace/) | Lets you start and join Pexip video meetings from Mattermost. |
+| [ServiceNow](/integrations-guide/servicenow) | > **App Marketplace** | Sends ServiceNow updates (like tickets or incidents) into Mattermost and lets you take action from chat. |
+| [Splunk](https://mattermost.com/marketplace/splunk-2/) | [Mattermost Marketplace](https://mattermost.com/marketplace/) | Sends Splunk alerts and search results directly into Mattermost channels. |
+| [Zoom](/integrations-guide/zoom) | > **App Marketplace** | Lets you start and join Zoom meetings from inside Mattermost. |
## More on Marketplace
diff --git a/docs/main/product-overview/faq-license.mdx b/docs/main/product-overview/faq-license.mdx
index a35ab17deced..efd23b1c9cb6 100644
--- a/docs/main/product-overview/faq-license.mdx
+++ b/docs/main/product-overview/faq-license.mdx
@@ -14,18 +14,30 @@ The following outlines the licensing, terms of use and privacy policies across M
You are welcome to use the Enterprise Edition of Mattermost free of charge in perpetuity when the subscription feature | | | are not enabled by a license key. +-------------------------------------------------------------------------------------------------------------------------------+ | | Self Managed Subscription Terms | | If you choose to purchase a subscription for paid features, terms and conditions are offered | | | as part of the subscription purchase (see “Terms”). | Enterprise Edition Subscription Terms for Purchase by Resale | | | | | | Cloud Subscription Agreement | |
Mattermost Enterprise Edition with no subscription
+
Commercial Enterprise Edition License. You are welcome to use the Enterprise Edition of Mattermost free of charge in perpetuity when the subscription features are not enabled by a license key.
+
No subscription terms apply when operating without a subscription
Mattermost Enterprise Edition with subscription
+
If you choose to purchase a subscription for paid features, terms and conditions are offered as part of the subscription purchase (see “Terms”).
diff --git a/docs/main/product-overview/faq-mattermost-source-available-license.mdx b/docs/main/product-overview/faq-mattermost-source-available-license.mdx
index 2fa5b64926a1..9cc4cd60b399 100644
--- a/docs/main/product-overview/faq-mattermost-source-available-license.mdx
+++ b/docs/main/product-overview/faq-mattermost-source-available-license.mdx
@@ -27,7 +27,7 @@ As we add enterprise-only functionality, we will update the license on affected
## To which repositories does this apply?
-We plan to apply this license to the enterprise directories of our [Jira](https://github.com/mattermost/mattermost-plugin-jira), [Microsoft Calendar Integration](https://github.com/mattermost/mattermost-plugin-mscalendar), and [Microsoft Teams Meetings](https://github.com/mattermost/mattermost-plugin-msteams-meetings) plugins. We also intend to release [Collaborative playbooks](/end-user-guide/workflow-automation) and [Channel Export](https://github.com/mattermost/mattermost-plugin-channel-export) plugins under the Mattermost Source Available License. New, Mattermost-authored plugins will generally be released under the Mattermost Source Available License. When we update the licenses, we will release a new version and note the change in the `README.md` file of the GitHub repository and any release notes.
+We plan to apply this license to the enterprise directories of our [Jira](https://github.com/mattermost/mattermost-plugin-jira), [Microsoft Calendar Integration](https://github.com/mattermost/mattermost-plugin-mscalendar), and [Microsoft Teams Meetings](https://github.com/mattermost/mattermost-plugin-msteams-meetings) plugins. We also intend to release [Collaborative playbooks](/end-user-guide/workflow-automation/workflow-automation-index) and [Channel Export](https://github.com/mattermost/mattermost-plugin-channel-export) plugins under the Mattermost Source Available License. New, Mattermost-authored plugins will generally be released under the Mattermost Source Available License. When we update the licenses, we will release a new version and note the change in the `README.md` file of the GitHub repository and any release notes.
We expect to keep plugins without an enterprise component under our open source license. No licensing changes are planned to non-plugin repositories, such as [mattermost](https://github.com/mattermost/mattermost) or [mattermost webapp](https://github.com/mattermost/mattermost/tree/master/webapp).
diff --git a/docs/main/product-overview/mattermost-v10-changelog.mdx b/docs/main/product-overview/mattermost-v10-changelog.mdx
index 8d5a0bad446a..478ae0888a66 100644
--- a/docs/main/product-overview/mattermost-v10-changelog.mdx
+++ b/docs/main/product-overview/mattermost-v10-changelog.mdx
@@ -17,12 +17,12 @@ Platform and OS scope reflects reported and tested environments and may not repr
## Release v10.12 - [Feature Release](https://docs.mattermost.com/product-overview/release-policy.html#release-types) \{#release-v10-12-feature-release}
- **10.12.4, released 2025-11-21**
-
+
**Critical Fixes**
- Mattermost v10.12.4 contains a Critical severity level security fix in the Jira plugin. [Upgrading](https://docs.mattermost.com/upgrade/upgrading-mattermost-server.html) to this release as soon as possible is highly recommended. Details will be posted on our [security updates page](https://mattermost.com/security-updates/) 30 days after release as per the [Mattermost Responsible Disclosure Policy](https://mattermost.com/security-vulnerability-report/).
-
+
- Pre-packaged Jira plugin version [v4.4.1](https://github.com/mattermost/mattermost-plugin-jira/releases/tag/v4.4.1).
- Mattermost v10.12.4 contains no database or functional changes.
- **10.12.3, released 2025-11-17**
@@ -32,12 +32,12 @@ Platform and OS scope reflects reported and tested environments and may not repr
- Fixed a configuration retention issue where even active configuration got deleted.
- Mattermost v10.12.3 contains no database or functional changes.
- **10.12.2, released 2025-10-28**
-
+
**Critical Fixes**
- Mattermost v10.12.2 contains Critical severity level security fixes. [Upgrading](https://docs.mattermost.com/upgrade/upgrading-mattermost-server.html) to this release as soon as possible is highly recommended. Details will be posted on our [security updates page](https://mattermost.com/security-updates/) 30 days after release as per the [Mattermost Responsible Disclosure Policy](https://mattermost.com/security-vulnerability-report/).
-
+
- Pre-packaged Boards plugin [v9.1.7](https://github.com/mattermost/mattermost-plugin-boards/releases/tag/v9.1.7).
- Mattermost v10.12.2 contains no database or functional changes.
- **10.12.1, released 2025-10-15**
@@ -85,12 +85,12 @@ If you upgrade from a release earlier than v10.10, please read the other [Import
## Release v10.11 - [Extended Support Release](https://docs.mattermost.com/product-overview/release-policy.html#release-types) \{#release-v10-11-extended-support-release}
-
+
**Known Issue**
- Customers should not upgrade from ``>=10.11.17`` to ``<=11.7.2`` due to a bug that causes an issue with database migration numbers. The bug is fixed in v11.7.3.
-
+
- **10.11.23, released 2026-08-13**
- Mattermost v10.11.23 contains low to high severity level security fixes. [Upgrading](https://docs.mattermost.com/upgrade/upgrading-mattermost-server.html) to this release is recommended. Details will be posted on our [security updates page](https://mattermost.com/security-updates/) 30 days after release as per the [Mattermost Responsible Disclosure Policy](https://mattermost.com/security-vulnerability-report/).
@@ -180,12 +180,12 @@ If you upgrade from a release earlier than v10.10, please read the other [Import
- Fixed an issue where rate limiting was missing from the login endpoint (5 requests/second, 10 burst).
- Mattermost v10.11.12 contains no database or functional changes.
- **10.11.11, released 2026-02-13**
-
+
**Breaking Changes**
- Photoshop Document (PSD) files are now no longer inline previewed, they are treated as regular file attachments.
-
+
- Mattermost v10.11.11 contains low to high severity level security fixes. [Upgrading](https://docs.mattermost.com/upgrade/upgrading-mattermost-server.html) to this release is recommended. Details will be posted on our [security updates page](https://mattermost.com/security-updates/) 30 days after release as per the [Mattermost Responsible Disclosure Policy](https://mattermost.com/security-vulnerability-report/).
- Pre-packaged Boards plugin version [v9.2.2](https://github.com/mattermost/mattermost-plugin-boards/releases/tag/v9.2.2).
- Fixed an issue where the channel URL got updated when the channel display name was changed.
@@ -216,12 +216,12 @@ If you upgrade from a release earlier than v10.10, please read the other [Import
- Fixed an issue where pressing ``Shift+Up`` in the channel textbox to reply to a thread could cause the right‑hand sidebar (RHS) reply textbox to not focus.
- Mattermost v10.11.9 contains no database or functional changes.
- **10.11.8, released 2025-11-21**
-
+
**Critical Fixes**
- Mattermost v10.11.8 contains a Critical severity level security fix in the Jira plugin. [Upgrading](https://docs.mattermost.com/upgrade/upgrading-mattermost-server.html) to this release as soon as possible is highly recommended. Details will be posted on our [security updates page](https://mattermost.com/security-updates/) 30 days after release as per the [Mattermost Responsible Disclosure Policy](https://mattermost.com/security-vulnerability-report/).
-
+
- Pre-packaged Jira plugin version [v4.4.1](https://github.com/mattermost/mattermost-plugin-jira/releases/tag/v4.4.1).
- Mattermost v10.11.8 contains no database or functional changes.
- **10.11.7, released 2025-11-17**
@@ -237,12 +237,12 @@ If you upgrade from a release earlier than v10.10, please read the other [Import
- Pre-packaged MS Teams Meeting plugin version [v2.3.0](https://github.com/mattermost/mattermost-plugin-msteams-meetings/releases/tag/v2.3.0).
- Mattermost v10.11.6 contains no database or functional changes.
- **10.11.5, released 2025-10-28**
-
+
**Critical Fixes**
- Mattermost v10.11.5 contains Critical severity level security fixes. [Upgrading](https://docs.mattermost.com/upgrade/upgrading-mattermost-server.html) to this release as soon as possible is highly recommended. Details will be posted on our [security updates page](https://mattermost.com/security-updates/) 30 days after release as per the [Mattermost Responsible Disclosure Policy](https://mattermost.com/security-vulnerability-report/).
-
+
- Pre-packaged Boards plugin [v9.1.7](https://github.com/mattermost/mattermost-plugin-boards/releases/tag/v9.1.7).
- Mattermost v10.11.5 contains no database or functional changes.
- **10.11.4, released 2025-10-15**
@@ -903,12 +903,12 @@ New setting options were added to ``config.json``. Below is a list of the additi
- Fixed Go v1.23 incompatibility issues with plugins.
- Mattermost v10.5.14 contains no database or functional changes.
- **10.5.13, released 2025-10-28**
-
+
**Critical Fixes**
- Mattermost v10.5.13 contains Critical severity level security fixes. [Upgrading](https://docs.mattermost.com/upgrade/upgrading-mattermost-server.html) to this release as soon as possible is highly recommended. Details will be posted on our [security updates page](https://mattermost.com/security-updates/) 30 days after release as per the [Mattermost Responsible Disclosure Policy](https://mattermost.com/security-vulnerability-report/).
-
+
- Pre-packaged Boards plugin [v9.1.7](https://github.com/mattermost/mattermost-plugin-boards/releases/tag/v9.1.7).
- Mattermost v10.5.13 contains no database or functional changes.
- **10.5.12, released 2025-10-15**
diff --git a/docs/main/product-overview/mattermost-v11-changelog.mdx b/docs/main/product-overview/mattermost-v11-changelog.mdx
index 29f571d2161a..412bc6781db6 100644
--- a/docs/main/product-overview/mattermost-v11-changelog.mdx
+++ b/docs/main/product-overview/mattermost-v11-changelog.mdx
@@ -16,12 +16,12 @@ Platform and OS scope reflects reported and tested environments and may not repr
## Release v11.10 - [Feature Release](https://docs.mattermost.com/product-overview/release-policy.html#release-types) \{#release-v11-10-feature-release}
-
+
**Breaking Changes**
- Starting with v11.10.1, the updated `glibc-openssl-fips` bundle includes a new OpenSSL build that enforces the FIPS minimum key length of 112 bits for HMAC operations. The PostgreSQL driver (lib/pq) passes the database password as the HMAC key during SCRAM authentication, so a password shorter than 112 bits, or 14 ASCII characters, now causes a panic on connect rather than a graceful failure. Before upgrading, FIPS deployments should verify that the password in `SqlSettings.DataSource` is at least 14 characters and rotate it in PostgreSQL if it is shorter. Standard, non-FIPS builds are unaffected.
-
+
- **11.10.1, released 2026-08-25**
- Mattermost v11.10.1 contains medium to high severity level security fixes. [Upgrading](https://docs.mattermost.com/upgrade/upgrading-mattermost-server.html) to this release is recommended. Details will be posted on our [security updates page](https://mattermost.com/security-updates/) 30 days after release as per the [Mattermost Responsible Disclosure Policy](https://mattermost.com/security-vulnerability-report/).
@@ -223,12 +223,12 @@ See [this blog post](https://mattermost.com/blog/mattermost-v11-10-is-now-availa
- **11.9.0, released 2026-07-16**
- Original 11.9.0 release.
-
+
**Breaking Changes**
- Mattermost v11.9 changes how redirect URI allowlist patterns are matched for OAuth Dynamic Client Registration (DCR). Patterns are now evaluated per URL component (scheme, host, path, and query) rather than as a whole-string glob. See the [Important Upgrade Notes](https://docs.mattermost.com/upgrade/important-upgrade-notes.html) for more details.
-
+
### Upgrade Impact
@@ -427,12 +427,12 @@ See [this blog post](https://mattermost.com/blog/mattermost-v11-9-is-now-availab
- **11.8.0, released 2026-06-16**
- Original 11.8.0 release.
-
+
**Breaking Changes**
- The Custom Profile Attributes property group is renamed from ``custom_profile_attributes`` to ``access_control``, and CPA fields and values are migrated from the legacy property model to the v2 model. The functionality of the CPA feature is unchanged. Plugin developers that use CPA will need to register against the new group name.
-
+
### Upgrade Impact
@@ -589,12 +589,12 @@ See [this blog post](https://mattermost.com/blog/mattermost-v11-8-0-is-now-avail
## Release v11.7 - [Extended Support Release](https://docs.mattermost.com/product-overview/release-policy.html#release-types) \{#release-v11-7-extended-support-release}
-
+
**Breaking Changes**
- Starting with v11.7.10, the updated `glibc-openssl-fips` bundle includes a new OpenSSL build that enforces the FIPS minimum key length of 112 bits for HMAC operations. The PostgreSQL driver (lib/pq) passes the database password as the HMAC key during SCRAM authentication, so a password shorter than 112 bits, or 14 ASCII characters, now causes a panic on connect rather than a graceful failure. Before upgrading, FIPS deployments should verify that the password in `SqlSettings.DataSource` is at least 14 characters and rotate it in PostgreSQL if it is shorter. Standard, non-FIPS builds are unaffected.
-
+
- **11.7.10, released 2026-08-26**
- Mattermost v11.7.10 contains low to high severity level security fixes. [Upgrading](https://docs.mattermost.com/upgrade/upgrading-mattermost-server.html) to this release is recommended. Details will be posted on our [security updates page](https://mattermost.com/security-updates/) 30 days after release as per the [Mattermost Responsible Disclosure Policy](https://mattermost.com/security-vulnerability-report/).
@@ -692,13 +692,13 @@ See [this blog post](https://mattermost.com/blog/mattermost-v11-8-0-is-now-avail
- **11.7.0, released 2026-05-15**
- Original 11.7.0 release.
-
+
**Breaking Changes**
- FIPS builds require a minimum of 14 characters for passwords, atmos/camo proxy configuration, and shared channel secrets. Shorter passwords for existing users will no longer be valid and require a password reset. Non-FIPS builds are unaffected.
- v11.7 includes Agents plugin v2. Please see [this guide](/agents/docs/upgrading_to_2.0) on how to upgrade the Mattermost Agents plugin from a v1.x release to v2.0.0. It covers the supported version path, the migrations that run automatically on first start of v2.0.0, the breaking changes and default-behavior flips that admins should know about before the upgrade window, and the verification steps to confirm the upgrade succeeded.
-
+
#### Database Schema Changes
- The following schema changes are included in the v11.7 release. No database downtime is expected for this upgrade. See the [Important Upgrade Notes](https://docs.mattermost.com/upgrade/important-upgrade-notes.html) for more details.
@@ -1186,12 +1186,12 @@ See [this blog post](https://mattermost.com/blog/mattermost-v11-5-is-now-availab
### Upgrade Impact
-
+
**Breaking Changes**
- Photoshop Document (PSD) files are now no longer inline previewed, they are treated as regular file attachments.
-
+
#### Database Schema Changes
- Added two new tables, ``Recaps`` and ``RecapChannels``. No database downtime is expected for this upgrade. See the [Important Upgrade Notes](https://docs.mattermost.com/upgrade/important-upgrade-notes.html) for more details.
@@ -1271,12 +1271,12 @@ See [this blog post](https://mattermost.com/blog/mattermost-v11-4-is-now-availab
- Fixed an issue where rate limiting was missing from the login endpoint (5 requests/second, 10 burst).
- Mattermost v11.3.2 contains no database or functional changes.
- **11.3.1, released 2026-02-13**
-
+
**Breaking Changes**
- Photoshop Document (PSD) files are now no longer inline previewed, they are treated as regular file attachments.
-
+
- Mattermost v11.3.1 contains medium to high severity level security fixes. [Upgrading](https://docs.mattermost.com/upgrade/upgrading-mattermost-server.html) to this release is recommended. Details will be posted on our [security updates page](https://mattermost.com/security-updates/) 30 days after release as per the [Mattermost Responsible Disclosure Policy](https://mattermost.com/security-vulnerability-report/).
- Pre-packaged Boards plugin version [v9.2.2](https://github.com/mattermost/mattermost-plugin-boards/releases/tag/v9.2.2).
- Pre-packaged Playbooks plugin version [v2.6.2](https://github.com/mattermost/mattermost-plugin-playbooks/releases/tag/v2.6.2).
@@ -1395,12 +1395,12 @@ See [this blog post](https://mattermost.com/blog/mattermost-v11-3-is-now-availab
- Fixed an issue where rate limiting was missing from the login endpoint (5 requests/second, 10 burst).
- Mattermost v11.2.4 contains no database or functional changes.
- **11.2.3, released 2026-02-13**
-
+
**Breaking Changes**
- Photoshop Document (PSD) files are now no longer inline previewed, they are treated as regular file attachments.
-
+
- Mattermost v11.2.3 contains medium to high severity level security fixes. [Upgrading](https://docs.mattermost.com/upgrade/upgrading-mattermost-server.html) to this release is recommended. Details will be posted on our [security updates page](https://mattermost.com/security-updates/) 30 days after release as per the [Mattermost Responsible Disclosure Policy](https://mattermost.com/security-vulnerability-report/).
- Pre-packaged Boards plugin version [v9.2.2](https://github.com/mattermost/mattermost-plugin-boards/releases/tag/v9.2.2).
- Pre-packaged Playbooks plugin version [v2.6.2](https://github.com/mattermost/mattermost-plugin-playbooks/releases/tag/v2.6.2).
@@ -1526,12 +1526,12 @@ See [this blog post](https://mattermost.com/blog/mattermost-v11-2-is-now-availab
- Fixed an issue where Chrome/Desktop App spell check on Windows often couldn't correct typos.
- Mattermost v11.1.2 contains no database or functional changes.
- **11.1.1, released 2025-11-21**
-
+
**Critical Fixes**
- Mattermost v11.1.1 contains a Critical severity level security fix in the Jira plugin. [Upgrading](https://docs.mattermost.com/upgrade/upgrading-mattermost-server.html) to this release as soon as possible is highly recommended. Details will be posted on our [security updates page](https://mattermost.com/security-updates/) 30 days after release as per the [Mattermost Responsible Disclosure Policy](https://mattermost.com/security-vulnerability-report/).
-
+
- Pre-packaged Jira plugin version [v4.4.1](https://github.com/mattermost/mattermost-plugin-jira/releases/tag/v4.4.1).
- Fixed an issue where thread popouts did not show the current user's status.
- Fixed an issue where clicking on a permalink to a reply in another thread would not navigate the main window.
@@ -1540,12 +1540,12 @@ See [this blog post](https://mattermost.com/blog/mattermost-v11-2-is-now-availab
- **11.1.0, released 2025-11-14**
- Original 11.1.0 release.
-
+
**Breaking Changes**
- 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).
-
+
### Upgrade Impact
@@ -1623,12 +1623,12 @@ See [this blog post](https://mattermost.com/blog/mattermost-v11-1-is-now-availab
- Mattermost v11.0.7 contains medium severity level security fixes. [Upgrading](https://docs.mattermost.com/upgrade/upgrading-mattermost-server.html) to this release is recommended. Details will be posted on our [security updates page](https://mattermost.com/security-updates/) 30 days after release as per the [Mattermost Responsible Disclosure Policy](https://mattermost.com/security-vulnerability-report/).
- Mattermost v11.0.7 contains no database or functional changes.
- **11.0.6, released 2025-11-21**
-
+
**Critical Fixes**
- Mattermost v11.0.6 contains a Critical severity level security fix in the Jira plugin. [Upgrading](https://docs.mattermost.com/upgrade/upgrading-mattermost-server.html) to this release as soon as possible is highly recommended. Details will be posted on our [security updates page](https://mattermost.com/security-updates/) 30 days after release as per the [Mattermost Responsible Disclosure Policy](https://mattermost.com/security-vulnerability-report/).
-
+
- Pre-packaged Jira plugin version [v4.4.1](https://github.com/mattermost/mattermost-plugin-jira/releases/tag/v4.4.1).
- Mattermost v11.0.6 contains no database or functional changes.
- **11.0.5, released 2025-11-17**
@@ -1639,12 +1639,12 @@ See [this blog post](https://mattermost.com/blog/mattermost-v11-1-is-now-availab
- Fixed an issue where plugins could not receive 3rd-party authorization headers.
- Mattermost v11.0.5 contains no database or functional changes.
- **11.0.4, released 2025-10-28**
-
+
**Critical Fixes**
- Mattermost v11.0.4 contains Critical severity level security fixes. [Upgrading](https://docs.mattermost.com/upgrade/upgrading-mattermost-server.html) to this release as soon as possible is highly recommended. Details will be posted on our [security updates page](https://mattermost.com/security-updates/) 30 days after release as per the [Mattermost Responsible Disclosure Policy](https://mattermost.com/security-vulnerability-report/).
-
+
- Fixed an issue where plugin configuration settings were incorrectly sanitized, causing API endpoints and plugins to receive masked values instead of actual configuration values.
- Pre-packaged Boards plugin [v9.1.7](https://github.com/mattermost/mattermost-plugin-boards/releases/tag/v9.1.7).
- Mattermost v11.0.4 contains no database or functional changes.
@@ -1655,7 +1655,7 @@ See [this blog post](https://mattermost.com/blog/mattermost-v11-1-is-now-availab
- **11.0.1, released 2025-10-16**
- Original 11.0.1 release.
-
+
**Breaking Changes**
- GitLab SSO has been deprecated from Team Edition. Deployments using GitLab SSO can remain on v10.11 ESR (with 12 months of security updates), transition 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).
@@ -1686,7 +1686,7 @@ See [this blog post](https://mattermost.com/blog/mattermost-v11-1-is-now-availab
- Stopped supporting manually installed plugins as per 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](https://docs.mattermost.com/deployment-guide/software-hardware-requirements.html#minimum-postgresql-database-support-policy) documentation for details.
-
+
### Upgrade Impact
diff --git a/docs/main/recipes/product-vulnerability-incident.mdx b/docs/main/recipes/product-vulnerability-incident.mdx
index ebb1a7826baa..0bfbace28526 100644
--- a/docs/main/recipes/product-vulnerability-incident.mdx
+++ b/docs/main/recipes/product-vulnerability-incident.mdx
@@ -7,7 +7,7 @@ After getting access to your Mattermost instance, you’d like to set up a workf
## Solution
-This guide walks through the set up of a product security incident room using [Collaborative Playbooks](/end-user-guide/workflow-automation) and [Channels](/end-user-guide/messaging-collaboration) with voice calling and screen sharing functionalities.
+This guide walks through the set up of a product security incident room using [Collaborative Playbooks](/end-user-guide/workflow-automation/workflow-automation-index) and [Channels](/end-user-guide/collaborate/collaborate-index) with voice calling and screen sharing functionalities.
### 1. Workspace setup
diff --git a/docs/main/security-guide/mobile-security.mdx b/docs/main/security-guide/mobile-security.mdx
index c306bb4fc783..0e45f16515f1 100644
--- a/docs/main/security-guide/mobile-security.mdx
+++ b/docs/main/security-guide/mobile-security.mdx
@@ -15,7 +15,7 @@ Administrators can remotely wipe Mattermost data from mobile devices in case of
### Compliance policies
-Mattermost can be integrated with mobile device management solutions to enforce compliance policies. These policies ensure that mobile devices accessing the application adhere to security standards, such as encryption, password complexity, and device integrity. Learm more about [compliance with Mattermost](/administration-guide/compliance-with-mattermost).
+Mattermost can be integrated with mobile device management solutions to enforce compliance policies. These policies ensure that mobile devices accessing the application adhere to security standards, such as encryption, password complexity, and device integrity. Learn more about [compliance with Mattermost](/administration-guide/comply/comply-index).
### Mobile access platforms
diff --git a/docs/main/use-case-guide/devops-collaboration.mdx b/docs/main/use-case-guide/devops-collaboration.mdx
index f38b3ceb9239..3fd028f39bce 100644
--- a/docs/main/use-case-guide/devops-collaboration.mdx
+++ b/docs/main/use-case-guide/devops-collaboration.mdx
@@ -16,8 +16,8 @@ Coordinating secure software delivery requires tight integration between code co
**Benefits**
- **Automate pipeline visibility and alerting** by integrating with CI/CD tools like GitLab, Jenkins, and GitHub Actions using the [Mattermost integrations platform](/integrations-guide/integrations-guide-index).
-- **Coordinate secure releases and hotfixes** using [Collaborative Playbooks](/end-user-guide/workflow-automation) to manage rollout steps, validation gates, and team notifications.
-- **Enable traceable delivery communications** through [channel-based collaboration](/end-user-guide/messaging-collaboration), ensuring build logs, changelogs, and approvals remain accessible and audit-ready.
+- **Coordinate secure releases and hotfixes** using [Collaborative Playbooks](/end-user-guide/workflow-automation/workflow-automation-index) to manage rollout steps, validation gates, and team notifications.
+- **Enable traceable delivery communications** through [channel-based collaboration](/end-user-guide/collaborate/collaborate-index), ensuring build logs, changelogs, and approvals remain accessible and audit-ready.
- **Support deployments in regulated and sovereign environments** using [self-hosted Kubernetes deployment models](/deployment-guide/server/deploy-kubernetes) for full control over CI/CD communications.
## Platform Engineering & Internal Developer Platforms (IDPs)
@@ -26,8 +26,8 @@ Platform teams need streamlined, secure ways to deliver services and enable deve
**Benefits**
-- **Centralize platform requests and updates** in [dedicated channels](/end-user-guide/messaging-collaboration) that organize provisioning, support, and environment status discussions.
-- **Automate ticket triage and escalation workflows** using [Playbooks](/end-user-guide/workflow-automation) to track response SLAs and ownership across platform operations.
+- **Centralize platform requests and updates** in [dedicated channels](/end-user-guide/collaborate/collaborate-index) that organize provisioning, support, and environment status discussions.
+- **Automate ticket triage and escalation workflows** using [Playbooks](/end-user-guide/workflow-automation/workflow-automation-index) to track response SLAs and ownership across platform operations.
- **Monitor infrastructure health and changes** with integrated feeds from [Prometheus, Grafana](/administration-guide/scale/deploy-prometheus-grafana-for-performance-monitoring), or custom observability tools—supporting faster feedback loops.
- **Support hybrid cloud and edge operations** through [deployment flexibility](/deployment-guide/server/server-deployment-planning#deployment-options) across public, private, and disconnected environments.
@@ -37,7 +37,7 @@ Real-time visibility and structured collaboration are critical during service de
**Benefits**
-- **Automate incident handling** with [Playbooks](/end-user-guide/workflow-automation) to track diagnostics, assign tasks, and issue updates—supporting NOC, SRE, and AppSec workflows.
+- **Automate incident handling** with [Playbooks](/end-user-guide/workflow-automation/workflow-automation-index) to track diagnostics, assign tasks, and issue updates—supporting NOC, SRE, and AppSec workflows.
- **Accelerate containment and recovery** by [integrating alerting tools](/integrations-guide/integrations-guide-index#webhooks) like PagerDuty, Opsgenie, and custom webhooks into secure Mattermost channels.
- **Ensure communication continuity** during outages using [high availability architecture](/deployment-guide/reference-architecture/scale/high-availability-cluster-based-deployment) and [support for disconnected environments](/deployment-guide/reference-architecture/deployment-scenarios/air-gapped-deployment).
- **Enable forensic review and audit** with [logging and export capabilities](/administration-guide/manage/logging#audit-logging) that preserve all incident-related communications.
@@ -49,7 +49,7 @@ Critical infrastructure DevSecOps must align with strict security, audit, and co
**Benefits**
- **Apply granular role-based access controls** using [advanced permissions](/administration-guide/onboard/advanced-permissions) and [channel-specific configurations](/administration-guide/manage/team-channel-members#advanced-access-controls) to protect sensitive workflows.
-- **Support supply chain security coordination** by using [Playbooks](/end-user-guide/workflow-automation) to manage SBOM reviews, vendor risk analysis, and software intake workflows across internal and external teams.
+- **Support supply chain security coordination** by using [Playbooks](/end-user-guide/workflow-automation/workflow-automation-index) to manage SBOM reviews, vendor risk analysis, and software intake workflows across internal and external teams.
- **Enforce secure collaboration behavior** through [custom Terms of Service](/administration-guide/comply/custom-terms-of-service), [data retention policies](/administration-guide/comply/data-retention-policy), and user authentication tied to [SSO and Entra ID](/administration-guide/onboard/sso-entraid).
- **Deploy in line** with [Zero Trust](/security-guide/zero-trust) principles with [self-managed, segmented deployments](/deployment-guide/server/server-deployment-planning#deployment-options) that enforce identity, access, and policy boundaries—suitable for classified or sovereign cloud environments.
diff --git a/docs/main/use-case-guide/integrated-security-operations.mdx b/docs/main/use-case-guide/integrated-security-operations.mdx
index ab813327b051..1a58074ed528 100644
--- a/docs/main/use-case-guide/integrated-security-operations.mdx
+++ b/docs/main/use-case-guide/integrated-security-operations.mdx
@@ -17,7 +17,7 @@ SOCs are the front lines of real-time monitoring, triage, and escalation. Coordi
**Benefits**
-- **Accelerate triage and response workflows** with [Collaborative Playbooks](/end-user-guide/workflow-automation) that automate escalations, task assignment, and ticket updates for consistent response execution.
+- **Accelerate triage and response workflows** with [Collaborative Playbooks](/end-user-guide/workflow-automation/workflow-automation-index) that automate escalations, task assignment, and ticket updates for consistent response execution.
- **Integrate detection pipelines and observability tools** using the [Mattermost integrations platform](/integrations-guide/integrations-guide-index) to surface alerts from SIEM, SOAR, and log analysis systems into dedicated response channels.
- **Maintain operational security and compliance** through [role-based permissions](/administration-guide/onboard/advanced-permissions) and [audit logging](/administration-guide/manage/logging#audit-logging) to safeguard sensitive incident data.
- **Operate in secure, classified, or hybrid environments** using Kubernetes or Linux on the infrastructure of your choice: Public cloud, organization data center, or fully air-gapped. [Explore deployment options](/deployment-guide/server/server-deployment-planning#deployment-options).
@@ -29,8 +29,8 @@ CERTs serve as rapid-response teams during high-risk events, requiring tight coo
**Benefits**
-- **Orchestrate high-stakes incident response** through [Collaborative Playbooks](/end-user-guide/workflow-automation) tailored for malware outbreaks, data exfiltration events, and zero-day exploits.
-- **Centralize and structure communication** with [channel-based collaboration](/end-user-guide/messaging-collaboration), including [file sharing](/end-user-guide/collaborate/share-files-in-messages), [threaded updates](/end-user-guide/collaborate/organize-conversations), and task-tracking across affected teams.
+- **Orchestrate high-stakes incident response** through [Collaborative Playbooks](/end-user-guide/workflow-automation/workflow-automation-index) tailored for malware outbreaks, data exfiltration events, and zero-day exploits.
+- **Centralize and structure communication** with [channel-based collaboration](/end-user-guide/collaborate/collaborate-index), including [file sharing](/end-user-guide/collaborate/share-files-in-messages), [threaded updates](/end-user-guide/collaborate/organize-conversations), and task-tracking across affected teams.
- **Enable coordination across geographies** using [multi-device access](/deployment-guide/deployment-guide-index) and [mobile EMM support](/deployment-guide/mobile/deploy-mobile-apps-using-emm-provider) for secure participation across locations and devices.
- **Preserve evidentiary and compliance data** through [audit logs](/administration-guide/manage/logging#audit-logging) and configurable [exports](/administration-guide/manage/bulk-export-tool) for legal review or forensic handoff.
- **Ensure data sovereignty** with flexible hosting options including EU-resident infrastructure, on-premises deployments, and air-gapped environments that maintain full control over sensitive communications.
diff --git a/docs/main/use-case-guide/maximize-microsoft-investments.mdx b/docs/main/use-case-guide/maximize-microsoft-investments.mdx
index 47badb9c6158..1783ea3c2976 100644
--- a/docs/main/use-case-guide/maximize-microsoft-investments.mdx
+++ b/docs/main/use-case-guide/maximize-microsoft-investments.mdx
@@ -40,7 +40,7 @@ Operational teams need to extend Microsoft capabilities to mission environments
**Benefits**
- **Enable mission-critical coordination at the edge** by [deploying Mattermost in secure, on-prem or air-gapped environments](/deployment-guide/server/server-deployment-planning#deployment-options) [integrated with Microsoft Teams and Outlook](/integrations-guide/mattermost-mission-collaboration-for-m365).
-- **Fuse data and decision-making across platforms** with support for [toolchain integration](/integrations-guide/integrations-guide-index), [audio/screen share](/end-user-guide/collaborate/make-calls), and [workflow automation](/end-user-guide/workflow-automation) embedded into a dedicated Mission Operations Platform.
+- **Fuse data and decision-making across platforms** with support for [toolchain integration](/integrations-guide/integrations-guide-index), [audio/screen share](/end-user-guide/collaborate/make-calls), and [workflow automation](/end-user-guide/workflow-automation/workflow-automation-index) embedded into a dedicated Mission Operations Platform.
- **Maintain coalition and partner alignment** through [interoperable Connected Workspaces](/administration-guide/onboard/connected-workspaces) supporting collaboration across mission partner networks.
- **Accelerate action with mission-tuned AI** using secure Azure AI and [Mattermost Copilot](/end-user-guide/agents) to summarize context, guide decisions, and automate operational tasks.
- **Secure every communication path** with built-in [Zero Trust controls](/security-guide/zero-trust) and deploy on Azure or sovereign environments for maximum flexibility and compliance.
diff --git a/docs/main/use-case-guide/out-of-band-incident-response.mdx b/docs/main/use-case-guide/out-of-band-incident-response.mdx
index 310f6bc5cb94..cf5dfea28ccd 100644
--- a/docs/main/use-case-guide/out-of-band-incident-response.mdx
+++ b/docs/main/use-case-guide/out-of-band-incident-response.mdx
@@ -30,7 +30,7 @@ Outages and downtime threaten both productivity and revenue. In large enterprise
**Benefits**
- **Scale communication globally** with Mattermost's [high availability and horizontal scalability architecture](/deployment-guide/reference-architecture/scale/scaling-for-enterprise), supporting tens of thousands of users across enterprise, field, government, or classified environments.
-- **Accelerate outage recovery** using [Collaborative Playbooks](/end-user-guide/workflow-automation) that automate response steps and ensure team accountability during time-critical events, reducing mean time to recovery (MTTR) by up to 50%.
+- **Accelerate outage recovery** using [Collaborative Playbooks](/end-user-guide/workflow-automation/workflow-automation-index) that automate response steps and ensure team accountability during time-critical events, reducing mean time to recovery (MTTR) by up to 50%.
- **Demonstrate ROI through measurable outcomes** with built-in metrics tracking incident response times, team coordination efficiency, and compliance audit trails.
## Incident Response in Crisis Conditions
@@ -41,7 +41,7 @@ Cyber breaches demand swift, coordinated action across affected teams. Every del
- **Ensure secure response coordination** through [private 1:1 calling and screen sharing](/end-user-guide/collaborate/make-calls) for uninterrupted incident discussions within an isolated Mattermost environment.
- **Integrate with your existing security stack** including ServiceNow, Grafana, Splunk, and other SOC tools via the [Mattermost integrations platform](/integrations-guide/integrations-guide-index).
-- **Reduce mean time to resolution (MTTR)** by executing [structured incident playbooks](/end-user-guide/workflow-automation) that handle triage, task assignment, and escalation with full visibility and auditability.
+- **Reduce mean time to resolution (MTTR)** by executing [structured incident playbooks](/end-user-guide/workflow-automation/workflow-automation-index) that handle triage, task assignment, and escalation with full visibility and auditability.
- **Support compliance reporting** with automated documentation and audit trails helping organizations to meet NIS2, HIPAA, PCI DSS, GDPR, and government security requirements.
## Get Started
diff --git a/docs/main/use-case-guide/purpose-built-collaboration.mdx b/docs/main/use-case-guide/purpose-built-collaboration.mdx
index 54db19a828ed..0f64378a075e 100644
--- a/docs/main/use-case-guide/purpose-built-collaboration.mdx
+++ b/docs/main/use-case-guide/purpose-built-collaboration.mdx
@@ -15,7 +15,7 @@ Coordinating logistics across continents, agencies, and time zones requires a se
**Benefits**
-- **Enable real-time coordination** across supply chains, procurement, and field units with [channel-based messaging](/end-user-guide/messaging-collaboration) and [playbook-driven workflows](/end-user-guide/workflow-automation) that standardize communication and reduce friction.
+- **Enable real-time coordination** across supply chains, procurement, and field units with [channel-based messaging](/end-user-guide/collaborate/collaborate-index) and [playbook-driven workflows](/end-user-guide/workflow-automation/workflow-automation-index) that standardize communication and reduce friction.
- **Connect systems across logistics networks** by integrating ERP, fleet tracking, maintenance management, and transportation tools via [webhooks, APIs, and plugins](/integrations-guide/integrations-guide-index).
- **Preserve operational continuity** during outages or disruptions using [self-hosted deployments](/deployment-guide/server/server-deployment-planning#deployment-options) and [high availability architecture](/deployment-guide/reference-architecture/scale/high-availability-cluster-based-deployment) that eliminate reliance on third-party cloud services.
- **Support multilingual coordination** with [localized UI options](/end-user-guide/preferences/manage-your-display-options#language) in 20+ languages to ensure inclusive collaboration across global teams.
@@ -40,10 +40,10 @@ Engineering, infrastructure, and security teams manage increasingly complex envi
**Benefits**
-- **Accelerate decision-making and incident response** using [Collaborative Playbooks](/end-user-guide/workflow-automation) to automate workflows for triage, patching, code releases, and security alerts.
-- **Customize your collaboration environment** with [theming](/end-user-guide/preferences/customize-your-theme), [custom branding](/administration-guide/configure/custom-branding-tools), and [channel templates](/end-user-guide/messaging-collaboration) to mirror internal teams and operational domains.
+- **Accelerate decision-making and incident response** using [Collaborative Playbooks](/end-user-guide/workflow-automation/workflow-automation-index) to automate workflows for triage, patching, code releases, and security alerts.
+- **Customize your collaboration environment** with [theming](/end-user-guide/preferences/customize-your-theme), [custom branding](/administration-guide/configure/custom-branding-tools), and [channel templates](/end-user-guide/collaborate/collaborate-index) to mirror internal teams and operational domains.
- **Extend platform capabilities** with [slash commands, bots, and custom plugins](/integrations-guide/integrations-guide-index) that connect Mattermost to CI/CD systems, alerting frameworks, ticketing platforms, and internal tools.
-- **Increase usability and team cohesion** with [custom emojis](/end-user-guide/collaborate/react-with-emojis-gifs#upload-custom-emojis), shared terminology, and [real-time messaging](/end-user-guide/messaging-collaboration) optimized for platform engineers, DevSecOps teams, and field service managers.
+- **Increase usability and team cohesion** with [custom emojis](/end-user-guide/collaborate/react-with-emojis-gifs#upload-custom-emojis), shared terminology, and [real-time messaging](/end-user-guide/collaborate/collaborate-index) optimized for platform engineers, DevSecOps teams, and field service managers.
## Get Started
diff --git a/docs/main/use-case-guide/secure-command-and-control.mdx b/docs/main/use-case-guide/secure-command-and-control.mdx
index 44a58eb05ea4..2819fb70b96e 100644
--- a/docs/main/use-case-guide/secure-command-and-control.mdx
+++ b/docs/main/use-case-guide/secure-command-and-control.mdx
@@ -15,10 +15,10 @@ In high-stakes missions—including classified operations—real-time collaborat
**Benefits**
-- **Surface essential context faster for decisive action** using [threaded messaging](/end-user-guide/collaborate/organize-conversations), [file previews](/end-user-guide/collaborate/share-files-in-messages), and [channel-based discussion](/end-user-guide/messaging-collaboration) to consolidate signals and reduce noise.
+- **Surface essential context faster for decisive action** using [threaded messaging](/end-user-guide/collaborate/organize-conversations), [file previews](/end-user-guide/collaborate/share-files-in-messages), and [channel-based discussion](/end-user-guide/collaborate/collaborate-index) to consolidate signals and reduce noise.
- **Integrate mission tooling and automation** via the [Mattermost integrations platform](/integrations-guide/integrations-guide-index)—connecting alerting, workflow engines, and tactical systems directly into operational channels.
- **Strengthen mobile communication channels** through [enterprise mobility security](/security-guide/mobile-security) that reduce reliance on personal messaging apps, control data exposure, and ensure secure, compliant access.
-- **Coordinate operations with structured workflows** using [Collaborative Playbooks](/end-user-guide/workflow-automation) that standardize task execution, streamline decision-making, and maintain continuity across teams and mission roles.
+- **Coordinate operations with structured workflows** using [Collaborative Playbooks](/end-user-guide/workflow-automation/workflow-automation-index) that standardize task execution, streamline decision-making, and maintain continuity across teams and mission roles.
- **Deploy sovereign AI for operational intelligence** using [air-gapped and private AI operations](/deployment-guide/reference-architecture/deployment-scenarios/air-gapped-deployment) to power decision support and automation in disconnected or classified settings.
## Disconnected, Intermittent, and Low-Bandwidth (DDIL) Collaboration
@@ -33,7 +33,7 @@ Disconnected environments demand resilient tools that work without cloud access,
- **Ensure secure mobile access on managed or BYOD devices** with [mobile security features](/deployment-guide/mobile/mobile-security-features), Zero Trust enforcement, and [ID-only push notifications](/administration-guide/configure/push-notification-server-configuration-settings#id-only-push-notifications) for sensitive alerts.
- **Integrate with legacy and mission-specific systems** to maintain decision advantage in disconnected environments through [custom-built, self-hosted integrations](/integrations-guide/integrations-guide-index) tailored to your operational infrastructure.
- **Maintain command resilience** using [high availability cluster-based deployment](/deployment-guide/reference-architecture/scale/scaling-for-enterprise) and [horizontal scalability](/deployment-guide/reference-architecture/scale/scaling-for-enterprise) to support operational continuity at scale.
-- **Automate field workflows** with [Collaborative Playbooks](/end-user-guide/workflow-automation) that track tasks, manage field updates, and orchestrate responses under DDIL constraints.
+- **Automate field workflows** with [Collaborative Playbooks](/end-user-guide/workflow-automation/workflow-automation-index) that track tasks, manage field updates, and orchestrate responses under DDIL constraints.
- **Enable secure real-time collaboration with headquarters** using [Connected Workspaces](/administration-guide/onboard/connected-workspaces) to synchronize discussions, files, and reactions if connectivity is restored.
## Bring Your Own Device (BYOD) with Sensitive Information Protections
diff --git a/docs/main/use-case-guide/self-sovereign-collaboration.mdx b/docs/main/use-case-guide/self-sovereign-collaboration.mdx
index 07dd277aeb3d..5f512d19c636 100644
--- a/docs/main/use-case-guide/self-sovereign-collaboration.mdx
+++ b/docs/main/use-case-guide/self-sovereign-collaboration.mdx
@@ -39,7 +39,7 @@ Cross-agency, multinational, or coalition collaboration requires sovereignty wit
- **Create secure shared workspaces** with [Connected Workspaces Channels](/administration-guide/onboard/connected-workspaces) that synchronize discussions, reactions, and file sharing across trusted organizations—without exposing internal systems.
- **Control access across organizations** with [attribute-based permissions](/administration-guide/onboard/advanced-permissions) and scoped identity policies to ensure mission alignment and sensitive information segmentation.
-- **Deploy sovereign AI and workflow automation** in isolated environments using [air-gapped AI operations](/end-user-guide/agents) and [Collaborative Playbooks](/end-user-guide/workflow-automation)—enabling intelligence and speed without compromising data control.
+- **Deploy sovereign AI and workflow automation** in isolated environments using [air-gapped AI operations](/end-user-guide/agents) and [Collaborative Playbooks](/end-user-guide/workflow-automation/workflow-automation-index)—enabling intelligence and speed without compromising data control.
## Unified Collaboration for Secure Workflows
@@ -49,10 +49,10 @@ Mattermost replaces legacy, on-premises communication systems with a modern, sov
**Benefits**
-- **Modernize secure messaging and team coordination** with [channel-based collaboration](/end-user-guide/messaging-collaboration), [threaded discussions](/end-user-guide/collaborate/organize-conversations), and [file sharing](/end-user-guide/collaborate/share-files-in-messages) that work across web, desktop, and mobile.
+- **Modernize secure messaging and team coordination** with [channel-based collaboration](/end-user-guide/collaborate/collaborate-index), [threaded discussions](/end-user-guide/collaborate/organize-conversations), and [file sharing](/end-user-guide/collaborate/share-files-in-messages) that work across web, desktop, and mobile.
- **Replace outdated platforms** like Skype for Business with a scalable, [self-hosted architecture](/deployment-guide/server/server-deployment-planning#deployment-options) that delivers enhanced user experience, compliance, and cross-organizational flexibility.
- **Protect sensitive information on mobile** using [enterprise-grade mobile security](/security-guide/mobile-security) including [biometric access](/deployment-guide/mobile/mobile-security-features#biometric-authentication), [jailbreak detection](/deployment-guide/mobile/mobile-security-features#jailbreak-and-root-detection), [screenshot prevention](/deployment-guide/mobile/mobile-security-features#screenshot-and-screen-recording-prevention), and remote wipe—ensuring secure access from personal or field-issued devices.
-- **Extend collaboration capabilities** using [integrated workflows and automations](/end-user-guide/workflow-automation) to replace manual coordination with policy-driven processes.
+- **Extend collaboration capabilities** using [integrated workflows and automations](/end-user-guide/workflow-automation/workflow-automation-index) to replace manual coordination with policy-driven processes.
- **Unify teams around a secure, customizable platform** that evolves with your mission and integrates with internal systems via [webhooks, plugins, and APIs](/integrations-guide/integrations-guide-index).
## Get Started
diff --git a/docs/pdf/books/administration-guide.json b/docs/pdf/books/administration-guide.json
index fca8369d5c53..a25a8a8018e6 100644
--- a/docs/pdf/books/administration-guide.json
+++ b/docs/pdf/books/administration-guide.json
@@ -5,9 +5,8 @@
"version": "unreleased",
"spine": [
"/administration-guide/administration-guide-index",
- "/administration-guide/cloud-workspace-management",
- "/administration-guide/compliance-with-mattermost",
- "/administration-guide/upgrade-mattermost",
+ "/administration-guide/comply/comply-index",
+ "/administration-guide/upgrade/upgrade-index",
"/administration-guide/comply/compliance-export",
"/administration-guide/comply/custom-terms-of-service",
"/administration-guide/comply/data-retention-policy",
@@ -31,6 +30,7 @@
"/administration-guide/manage/cloud-byok",
"/administration-guide/manage/cloud-data-residency",
"/administration-guide/manage/cloud-ip-filtering",
+ "/administration-guide/manage/cloud-workspace-management",
"/administration-guide/manage/code-signing-custom-builds",
"/administration-guide/manage/command-line-tools",
"/administration-guide/manage/configure-health-check-probes",
diff --git a/docs/pdf/books/end-user-guide.json b/docs/pdf/books/end-user-guide.json
index 28f09921b2b4..d2442dae55a0 100644
--- a/docs/pdf/books/end-user-guide.json
+++ b/docs/pdf/books/end-user-guide.json
@@ -6,10 +6,10 @@
"spine": [
"/end-user-guide/agents",
"/end-user-guide/end-user-guide-index",
- "/end-user-guide/messaging-collaboration",
- "/end-user-guide/preferences",
- "/end-user-guide/project-task-management",
- "/end-user-guide/workflow-automation",
+ "/end-user-guide/collaborate/collaborate-index",
+ "/end-user-guide/preferences/preferences-index",
+ "/end-user-guide/project-management/project-management-index",
+ "/end-user-guide/workflow-automation/workflow-automation-index",
"/end-user-guide/access/access-your-workspace",
"/end-user-guide/access/install-android-app",
"/end-user-guide/access/install-desktop-app",
diff --git a/docs/site/scripts/gen-documentation-sidebar.mjs b/docs/site/scripts/gen-documentation-sidebar.mjs
index cbdbe8fc5a0c..967e8b295f5d 100644
--- a/docs/site/scripts/gen-documentation-sidebar.mjs
+++ b/docs/site/scripts/gen-documentation-sidebar.mjs
@@ -545,6 +545,7 @@ const ADMIN_MANAGE_GROUPS = {
},
cloudWorkspace: {
label: 'Cloud Workspace Management',
+ landing: 'cloud-workspace-management',
items: [
'cloud-data-export',
'cloud-data-residency',
@@ -887,6 +888,10 @@ const ADMIN_SCALE_ORDER = [
// ADMIN_SCALE_ORDER) rather than nested inside a sub-group.
const ADMIN_SCALE_HIDDEN = new Set([]);
+const ADMIN_ROOT_ORDER = ['Configure', 'Comply', 'Onboard', 'Manage', 'Upgrade', 'Scale'];
+
+const ENDUSER_ROOT_ORDER = ['Access', 'Collaborate', 'Workflow Automation', 'Project Management', 'AI Agents', 'Preferences'];
+
// ---------------------------------------------------------------------------
// Integrations Guide — manual grouping override.
// ---------------------------------------------------------------------------
@@ -1057,7 +1062,7 @@ function buildCategory(absDir, docsRelDir) {
}
const label =
- (indexFile && readFm(join(absDir, indexFile), 'title')) ||
+ (indexFile && (readFm(join(absDir, indexFile), 'sidebar_label') || readFm(join(absDir, indexFile), 'title'))) ||
humanize(basename(absDir));
if (!categoryLink && items.length === 0) return null;
@@ -1065,6 +1070,46 @@ function buildCategory(absDir, docsRelDir) {
return {type: 'category', label, collapsed: true, ...(categoryLink ? {link: categoryLink} : {}), items};
}
+// The content sub-directory a category was built from (e.g. 'comply' for
+// administration-guide/comply/), read off its landing page or first doc.
+// Used by buildAdminGuideSidebar/buildEndUserGuideSidebar below to find the
+// Configure/Manage/Onboard/Scale/Collaborate sub-category to regroup,
+// independent of its (label-based) display text.
+function categoryDirName(cat) {
+ if (cat.link && cat.link.id) return cat.link.id.split('/')[1];
+ const items = cat.items || [];
+ const firstDoc = items.find((c) => c.type === 'doc' && c.id);
+ if (firstDoc) return firstDoc.id.split('/')[1];
+ // Regrouped categories (e.g. Onboard) hold only sub-groups at the top level.
+ for (const it of items) {
+ if (it.type !== 'category') continue;
+ const nested = categoryDirName(it);
+ if (nested) return nested;
+ }
+ return null;
+}
+
+// Reorder a guide's top-level categories by label. Anything not named in
+// `order` keeps its relative position at the end.
+function orderRootCategories(sectionCat, order, sectionLabel) {
+ const rank = new Map(order.map((label, i) => [label, i]));
+ const listed = [];
+ const rest = [];
+ for (const it of sectionCat.items) {
+ if (it.type === 'category' && rank.has(it.label)) listed.push(it);
+ else rest.push(it);
+ }
+ listed.sort((a, b) => rank.get(a.label) - rank.get(b.label));
+
+ const missing = order.filter((label) => !listed.some((it) => it.label === label));
+ if (missing.length > 0) {
+ console.warn(`[sidebar] WARN: ${sectionLabel} root order names categor(y/ies) that don't exist: ${missing.join(', ')}`);
+ }
+
+ sectionCat.items = [...listed, ...rest];
+ return sectionCat;
+}
+
// Pull every doc label from an auto-generated category so a manual ordering
// preserves the frontmatter-derived titles.
function collectLeafLabels(cat, acc = {}) {
@@ -1474,14 +1519,7 @@ function buildAdminGuideSidebar(autoCat) {
let foundScale = false;
for (const it of autoCat.items) {
if (it.type !== 'category') continue;
- let dirName = null;
- if (it.link && it.link.id) {
- dirName = it.link.id.split('/')[1];
- }
- if (!dirName && it.items) {
- const firstDoc = it.items.find((c) => c.type === 'doc' && c.id);
- if (firstDoc) dirName = firstDoc.id.split('/')[1];
- }
+ const dirName = categoryDirName(it);
if (dirName === 'configure') {
regroupAdminConfigure(it);
foundConfigure = true;
@@ -1508,6 +1546,8 @@ function buildAdminGuideSidebar(autoCat) {
if (!foundScale) {
console.warn('[sidebar] WARN: Administration Guide "Scale" sub-category not found — ADMIN_SCALE_GROUPS override was not applied.');
}
+
+ orderRootCategories(autoCat, ADMIN_ROOT_ORDER, 'Administration Guide');
return autoCat;
}
@@ -1676,15 +1716,7 @@ function buildEndUserGuideSidebar(autoCat) {
let foundCollaborate = false;
for (const it of autoCat.items) {
if (it.type !== 'category') continue;
- let dirName = null;
- if (it.link && it.link.id) {
- dirName = it.link.id.split('/')[1];
- }
- if (!dirName && it.items) {
- const firstDoc = it.items.find((c) => c.type === 'doc' && c.id);
- if (firstDoc) dirName = firstDoc.id.split('/')[1];
- }
- if (dirName === 'collaborate') {
+ if (categoryDirName(it) === 'collaborate') {
regroupCollaborate(it);
foundCollaborate = true;
}
@@ -1693,6 +1725,7 @@ function buildEndUserGuideSidebar(autoCat) {
console.warn('[sidebar] WARN: End User Guide "Collaborate" sub-category not found — COLLABORATE_GROUPS override was not applied.');
}
+ orderRootCategories(autoCat, ENDUSER_ROOT_ORDER, 'End User Guide');
return autoCat;
}
diff --git a/docs/site/sidebars/active-redirects.json b/docs/site/sidebars/active-redirects.json
index 99d4c3dd727d..6b5060337873 100644
--- a/docs/site/sidebars/active-redirects.json
+++ b/docs/site/sidebars/active-redirects.json
@@ -1,7 +1,7 @@
{
"_meta": {
"source": "docs-site/scripts/migrate-main-docs/redirects.json",
- "active": 691,
+ "active": 698,
"missing_target": 217,
"dropped_anchored_from": 1113,
"total_internal": 2021
@@ -1301,7 +1301,7 @@
},
{
"from": "/guides/playbooks",
- "to": "/end-user-guide/workflow-automation"
+ "to": "/end-user-guide/workflow-automation/workflow-automation-index"
},
{
"from": "/guides/welcome-to-mattermost",
@@ -1409,7 +1409,7 @@
},
{
"from": "/incident-collaboration/launching-playbooks",
- "to": "/end-user-guide/workflow-automation"
+ "to": "/end-user-guide/workflow-automation/workflow-automation-index"
},
{
"from": "/incident-collaboration/overview",
@@ -1417,7 +1417,7 @@
},
{
"from": "/incident-collaboration/playbook-planning",
- "to": "/end-user-guide/workflow-automation"
+ "to": "/end-user-guide/workflow-automation/workflow-automation-index"
},
{
"from": "/incident-collaboration/review-and-refine",
@@ -1425,7 +1425,7 @@
},
{
"from": "/incident-collaboration/running-playbooks",
- "to": "/end-user-guide/workflow-automation"
+ "to": "/end-user-guide/workflow-automation/workflow-automation-index"
},
{
"from": "/incident-collaboration/refining-and-improving",
@@ -1433,7 +1433,7 @@
},
{
"from": "/incident-collaboration/setting-up-playbooks",
- "to": "/end-user-guide/workflow-automation"
+ "to": "/end-user-guide/workflow-automation/workflow-automation-index"
},
{
"from": "/install/desktop-app-managed-resources",
@@ -2253,11 +2253,11 @@
},
{
"from": "/playbooks/setting-up-playbooks",
- "to": "/end-user-guide/workflow-automation"
+ "to": "/end-user-guide/workflow-automation/workflow-automation-index"
},
{
"from": "/playbooks/running-playbooks",
- "to": "/end-user-guide/workflow-automation"
+ "to": "/end-user-guide/workflow-automation/workflow-automation-index"
},
{
"from": "/playbooks/refining-and-improving",
@@ -2265,7 +2265,7 @@
},
{
"from": "/playbooks/customize-a-playbook",
- "to": "/end-user-guide/workflow-automation"
+ "to": "/end-user-guide/workflow-automation/workflow-automation-index"
},
{
"from": "/playbooks/customize-a-run",
@@ -2313,7 +2313,7 @@
},
{
"from": "/playbooks/get-started-with-playbooks",
- "to": "/end-user-guide/workflow-automation"
+ "to": "/end-user-guide/workflow-automation/workflow-automation-index"
},
{
"from": "/preferences/manage-your-calls-preferences",
@@ -2557,11 +2557,11 @@
},
{
"from": "/guides/cloud-workspace-management",
- "to": "/administration-guide/cloud-workspace-management"
+ "to": "/administration-guide/manage/cloud-workspace-management"
},
{
"from": "/guides/compliance-with-mattermost",
- "to": "/administration-guide/compliance-with-mattermost"
+ "to": "/administration-guide/comply/comply-index"
},
{
"from": "/guides/deployment-troubleshooting",
@@ -2569,15 +2569,15 @@
},
{
"from": "/guides/messaging-collaboration",
- "to": "/end-user-guide/messaging-collaboration"
+ "to": "/end-user-guide/collaborate/collaborate-index"
},
{
"from": "/guides/preferences",
- "to": "/end-user-guide/preferences"
+ "to": "/end-user-guide/preferences/preferences-index"
},
{
"from": "/guides/project-task-management",
- "to": "/end-user-guide/project-task-management"
+ "to": "/end-user-guide/project-management/project-management-index"
},
{
"from": "/guides/secure-mattermost",
@@ -2585,11 +2585,39 @@
},
{
"from": "/guides/upgrade-mattermost",
- "to": "/administration-guide/upgrade-mattermost"
+ "to": "/administration-guide/upgrade/upgrade-index"
},
{
"from": "/guides/workflow-automation",
- "to": "/end-user-guide/workflow-automation"
+ "to": "/end-user-guide/workflow-automation/workflow-automation-index"
+ },
+ {
+ "from": "/administration-guide/cloud-workspace-management",
+ "to": "/administration-guide/manage/cloud-workspace-management"
+ },
+ {
+ "from": "/administration-guide/compliance-with-mattermost",
+ "to": "/administration-guide/comply/comply-index"
+ },
+ {
+ "from": "/administration-guide/upgrade-mattermost",
+ "to": "/administration-guide/upgrade/upgrade-index"
+ },
+ {
+ "from": "/end-user-guide/messaging-collaboration",
+ "to": "/end-user-guide/collaborate/collaborate-index"
+ },
+ {
+ "from": "/end-user-guide/preferences",
+ "to": "/end-user-guide/preferences/preferences-index"
+ },
+ {
+ "from": "/end-user-guide/project-task-management",
+ "to": "/end-user-guide/project-management/project-management-index"
+ },
+ {
+ "from": "/end-user-guide/workflow-automation",
+ "to": "/end-user-guide/workflow-automation/workflow-automation-index"
},
{
"from": "/guides/about-mattermost",
diff --git a/docs/site/src/components/Callout/index.tsx b/docs/site/src/components/Callout/index.tsx
index 12e2f2b6797d..aedb6ea4d6fc 100644
--- a/docs/site/src/components/Callout/index.tsx
+++ b/docs/site/src/components/Callout/index.tsx
@@ -1,12 +1,13 @@
import React from 'react';
import styles from './styles.module.css';
-type Kind = 'note' | 'tip' | 'important' | 'warning' | 'security';
+type Kind = 'note' | 'tip' | 'important' | 'attention' | 'warning' | 'security';
const COPY: Record = {
note: {label: 'Note', icon: 'i'},
tip: {label: 'Tip', icon: '+'},
important: {label: 'Important', icon: '!'},
+ attention: {label: 'Attention', icon: '!'},
warning: {label: 'Warning', icon: '!'},
security: {label: 'Security', icon: 'S'},
};
@@ -23,13 +24,11 @@ export default function Callout({
const meta = COPY[kind];
return (
})
})
+})
+})
+})
+})
+})
+})
+})
+})
+})
+})
})
})
Online})
Away})
Do Not Disturb})
Offline})
> **App Marketplace** | Exports channel history and data for compliance purposes. |
+| [Mattermost Legal Hold](/administration-guide/comply/legal-hold) | Manual Upload | Keeps a copy of messages and files so they cannot be deleted for legal or compliance needs. |
+| [Mattermost Metrics](/administration-guide/scale/collect-performance-metrics) |