Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
22 commits
Select commit Hold shift + click to select a range
e5b14d8
Updating ServiceNow plugin setup documentation
ogi-m Jun 12, 2026
f5d9ed3
Update autotranslate-messages.rst (#9040)
wiersgallak Jun 15, 2026
927f8bc
docs: add Enterprise Advanced to subscription grace period downgrade …
ewwollesen Jun 15, 2026
8f28007
Update community-chat.rst (#9039)
Piyush123-cmd Jun 15, 2026
f2573a3
Mobile v2.41 changelog (#8980)
amyblais Jun 16, 2026
7451869
V11.8 Docs (#8974)
amyblais Jun 16, 2026
940b724
Add note that Mattermost limits frames in animated GIF custom emojis …
fmartingr Jun 16, 2026
91b2f28
Desktop app v5.13.7 and v6.2.1 dot release docs (#9008)
amyblais Jun 17, 2026
ec930d9
Dot release docs for v11.8.1 and v11.7.4 (#9047)
amyblais Jun 17, 2026
f4e5c0d
Document v11.8.0 membership policies, recommended channels, leave con…
Combs7th Jun 18, 2026
7c6892f
Mobile v2.41.1 docs (#9046)
amyblais Jun 18, 2026
536fa23
Fix OutgoingIntegrationRequestsTimeout config key name and default va…
mgdelacroix Jun 19, 2026
3dc6d48
Fix Documentation Link: Replace n8n Integration URL with Zapier Integ…
varghesejose2020 Jun 22, 2026
63455e8
docs: clarify GitHub webhook setup (org vs repo) and warn about dupli…
ewwollesen Jun 22, 2026
82ed9c0
Refactor port tables to use list-table format and improve clarity (#9…
hanzei Jun 22, 2026
fe2c1be
fix: add :orphan: and :nosearch: to included-only RST files (#7072) (…
rafaumeu Jun 22, 2026
faa9c17
Updated Multi-Team Functionality Clarification (#9027)
CooperWang0912 Jun 22, 2026
59edb3c
Merge branch 'master' into servicenow-plugin-docs-update-1
esethna Jun 22, 2026
c46f1ce
MM-68316: recommend builtin DB readiness check for K8s deployments (#…
nickmisasi Jun 22, 2026
82c5531
docs: fix broken code, command, and link examples (#9012)
emmayusufu Jun 22, 2026
2b08f6f
Desktop app v6.2.2 dot release docs (#9060)
amyblais Jun 23, 2026
35e4cc5
Merge branch 'master' into servicenow-plugin-docs-update-1
esethna Jun 24, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -58,7 +58,7 @@ Include the ``token`` value sent in the response as part of the Authorization he

.. code-block:: sh

curl -i -H 'Authorization: Bearer yi94pwci6ibjfc9phbikhqutbe http://yourmattermosturl/api/v4/users/me'
curl -i -H 'Authorization: Bearer yi94pwci6ibjfc9phbikhqutbe' http://yourmattermosturl/api/v4/users/me

Once you're authenticated into Mattermost, you can use the `Compliance API to create a new compliance report <https://api.mattermost.com/#tag/compliance%2Fpaths%2F~1compliance~1reports%2Fpost>`__. The curl based example below demonstrates how to send a request that bases the authentication token and asks Mattermost to create a report that spans posts from Dec 31, 2017 - 8:15 PM to Dec 31, 2018 - 8:15 PM for a user with the email address craig@mattermost.com:

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -821,9 +821,6 @@ ID attribute
.. note::
If a user's ID Attribute changes, a new Mattermost account is created that is not associated with the previous account. If you need to change this field after users have signed-in, use the :ref:`mmctl ldap idmigrate <administration-guide/manage/mmctl-command-line-tool:mmctl ldap idmigrate>` command.

.. note::
The ID attribute value is matched verbatim - Mattermost applies no case normalization. With PostgreSQL's default case-sensitive collation, a change in casing is treated as a new user and a separate account is created. Ensure your AD/LDAP server returns this attribute with consistent casing.

.. config:setting:: login-id-attribute
:displayname: Login ID attribute (AD/LDAP > Account Synchronization)
:systemconsole: Authentication > AD/LDAP
Expand Down Expand Up @@ -1032,9 +1029,6 @@ Group ID attribute
.. note::
This attribute is only used when AD/LDAP Group Sync is enabled and it is **required**. See the :doc:`AD/LDAP Group Sync documentation </administration-guide/onboard/ad-ldap-groups-synchronization>` for more information.

.. note::
The Group ID attribute value is matched verbatim - Mattermost applies no case normalization. With PostgreSQL's default case-sensitive collation, a change in casing means Mattermost no longer recognizes the previously synced group and treats it as a new, unlinked group. Ensure your AD/LDAP server returns this attribute with consistent casing.

Synchronization performance
~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Expand Down Expand Up @@ -1561,9 +1555,6 @@ Id attribute
| String input. | - Environment variable: ``MM_SAMLSETTINGS_IDATTRIBUTE`` |
+----------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------+

.. note::
The ID attribute value is matched verbatim - Mattermost applies no case normalization. With PostgreSQL's default case-sensitive collation, a change in casing is treated as a new user and a separate account is created. Ensure your identity provider returns this attribute with consistent casing.

.. config:setting:: guest-attribute
:displayname: Guest attribute (SAML)
:systemconsole: Authentication > SAML 2.0
Expand Down
217 changes: 0 additions & 217 deletions source/administration-guide/configure/azure-blob-storage.rst

This file was deleted.

Original file line number Diff line number Diff line change
Expand Up @@ -9,8 +9,7 @@ Chinese, Japanese and Korean search

.. attention::

Starting in Mattermost v11.9, CJK post search is enabled by default on PostgreSQL.
In Mattermost v11.5 through v11.8, enable the `feature flag <https://developers.mattermost.com/contribute/more-info/server/feature-flags/#changing-feature-flag-values>`_ ``MM_FEATUREFLAGS_CJKSEARCH``.
Starting on Mattermost v11.5, searching for Chinese, Japanese or Korean (CJK) characters can be enabled with the `feature flag <https://developers.mattermost.com/contribute/more-info/server/feature-flags/#changing-feature-flag-values>`_ ``MM_FEATUREFLAGS_CJKSEARCH``.

The general recommendation of `using either Elasticsearch or Opensearch once the server reaches 2.5 million posts <https://docs.mattermost.com/administration-guide/scale/enterprise-search.html#do-i-need-to-use-elasticsearch-or-aws-opensearch>`_ still applies.

Expand Down Expand Up @@ -87,7 +86,7 @@ Below is additional information on how to configure the database for different l
.. code-block:: sql

-- 创建 extension
CREATE EXTENSION zhparser
CREATE EXTENSION zhparser;
-- 创建 text search configuration
CREATE TEXT SEARCH CONFIGURATION simple_zh_cfg (PARSER = zhparser);
-- 配置 token mapping
Expand Down

Large diffs are not rendered by default.

Original file line number Diff line number Diff line change
Expand Up @@ -1520,6 +1520,9 @@ From Mattermost v10.10, when this :ref:`experimental <administration-guide/manag
| This feature's ``config.json`` setting is ``"ExperimentalEnableChannelCategorySorting": false`` with options ``true`` and ``false``. |
+------------------------------------------------------------------------------------------------------------------------------------------+

.. note::
From Mattermost v11.8, channel category sorting is generally available and enabled by default. Configure it from **System Console > Site Configuration > Users and Teams** using the :ref:`Channel category sorting <administration-guide/configure/site-configuration-settings:channel category sorting>` setting (``TeamSettings.EnableChannelCategorySorting``).

.. config:setting:: strict-csrf-token-enforcement
:displayname: Strict CSRF token enforcement (Experimental)
:systemconsole: N/A
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -187,18 +187,18 @@ This setting applies only when :ref:`Enable dynamic client registration <adminis
.. config:setting:: integration-request-timeout
:displayname: Integration request timeout (Integrations)
:systemconsole: Integrations > Integration Management
:configjson: .ServiceSettings.OutgoingIntegrationRequestsDefaultTimeout
:environment: MM_SERVICESETTINGS_OUTGOINGINTEGRATIONREQUESTDEFAULTTIMEOUT
:description: The number of seconds to wait for external integration HTTP requests, before timing out. Default value is **3 seconds**.
:configjson: .ServiceSettings.OutgoingIntegrationRequestsTimeout
:environment: MM_SERVICESETTINGS_OUTGOINGINTEGRATIONREQUESTSTIMEOUT
:description: The number of seconds to wait for external integration HTTP requests before timing out. Default value is **30 seconds**.

Integration request timeout
~~~~~~~~~~~~~~~~~~~~~~~~~~~

The number of seconds to wait for external integration HTTP requests, before timing out, including `custom slash commands <https://developers.mattermost.com/integrate/slash-commands/custom/>`_, `outgoing webhooks <https://developers.mattermost.com/integrate/webhooks/outgoing/>`_, `interactive messages <https://developers.mattermost.com/integrate/plugins/interactive-messages/>`_, and `interactive dialogs <https://developers.mattermost.com/integrate/plugins/interactive-dialogs/>`_. Increase this value if you have external integrations that can take some time to generate an HTTP response, or experience delayed responses due to latency.
The number of seconds to wait for external integration HTTP requests before timing out, including `custom slash commands <https://developers.mattermost.com/integrate/slash-commands/custom/>`_, `outgoing webhooks <https://developers.mattermost.com/integrate/webhooks/outgoing/>`_, `interactive messages <https://developers.mattermost.com/integrate/plugins/interactive-messages/>`_, and `interactive dialogs <https://developers.mattermost.com/integrate/plugins/interactive-dialogs/>`_. Increase this value if you have external integrations that can take some time to generate an HTTP response, or experience delayed responses due to latency.

+------------------------------------------------------------------------------------------------+
| This feature's ``config.json`` setting is ``"OutgoingIntegrationRequestsDefaultTimeout": 3``. |
+------------------------------------------------------------------------------------------------+
+---------------------------------------------------------------------------------------------+
| This feature's ``config.json`` setting is ``"OutgoingIntegrationRequestsTimeout": 30``. |
+---------------------------------------------------------------------------------------------+

.. config:setting:: enable-integrations-to-override-usernames
:displayname: Enable integrations to override usernames (Integrations)
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,18 +6,20 @@ Reporting configuration settings

View the following statistics for your overall deployment and specific teams, as well as access server logs, in the System Console by selecting the **Product** |product-list| menu, selecting **System Console**, and then selecting **Reporting**:

- `Site statistics <#site-statistics>`__
- `System statistics <#system-statistics>`__
- `Team statistics <#team-statistics>`__
- `Server logs <#server-logs>`__
- `Statistics configuration settings <#statistics-configuration-settings>`__

----

Site statistics
.. _site-statistics:

System statistics
---------------

+----------------------------------------------------------------+---------------------------------------------------------------------+
| View statistics on a wide variety of activities in Mattermost, | - System Config path: **Reporting > Site Statistics** |
| View statistics on a wide variety of activities in Mattermost, | - System Config path: **Reporting > System Statistics** |
| including: users, seats, teams, channels, posts, calls, | - ``config.json setting``: N/A |
| sessions, commands, webhooks, websocket and database | - Environment variable: N/A |
| connections, and collaborative playbooks. | |
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -18,6 +18,7 @@ Review and manage the following site configuration options in the System Console
- `Public Links <#public-links>`__
- `Notices <#notices>`__
- `Connected Workspaces <#connected-workspaces>`__
- `Classification Markings <#classification-markings>`__

.. tip::

Expand Down Expand Up @@ -253,7 +254,7 @@ Report a Problem

With self-hosted deployments, you can specify how the **Report a Problem** option behaves in the Mattermost app via the **Help** menu:

- **Default link**: Uses the default Mattermost URL to report a problem. Customers with a Mattermost subscription are directed to the `Mattermost Support Portal <https://support.mattermost.com/hc/en-us/requests/new>`_. Community deployments are directed to `create a new issue on the Mattermost GitHub repository <https://github.com/mattermost/mattermost/issues/new>`_.
- **Default**: Customers with a Mattermost license can open a support case by email with the Mattermost support team. Unlicensed Mattermost deployments are directed to the `troubleshooting forums <https://mattermost.com/pl/report_a_problem_unlicensed>`_.
- **Email address**: Enables you to :ref:`enter an email address <administration-guide/configure/site-configuration-settings:report a problem email address>` that users will be prompted to send a message to when they choose **Report a Problem** in Mattermost.
- **Custom link**: Enables you to :ref:`enter a URL <administration-guide/configure/site-configuration-settings:report a problem link>` that users will be directed to when they choose **Report a Problem** in Mattermost.
- **Hide link**: Removes the **Report a Problem** option from Mattermost.
Expand Down Expand Up @@ -282,7 +283,7 @@ Report a Problem link
:displayname: Report a Problem email (Customization)
:systemconsole: Site Configuration > Customization
:configjson: .SupportSettings.ReportAProblemMail
:environment: MM_SUPPORTSETTINGS_REPORTAPROBLMEMAIL
:environment: MM_SUPPORTSETTINGS_REPORTAPROBLEMMAIL
:description: Enter the email address that users will be prompted to send a message to when they choose Report a Problem in Mattermost.

Report a Problem email address
Expand All @@ -291,7 +292,7 @@ Report a Problem email address
+---------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------+
| This field sets the email address for the **Report a Problem** link in the channel | - System Config path: **Site Configuration > Customization** |
| header **Help** menu. | - ``config.json`` setting: ``SupportSettings`` > ``ReportAProblemMail`` |
| | - Environment variable: ``MM_SUPPORTSETTINGS_REPORTAPROBLMEMAIL`` |
| | - Environment variable: ``MM_SUPPORTSETTINGS_REPORTAPROBLEMMAIL`` |
| String input. Cannot be left blank. | |
+---------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------+

Expand Down Expand Up @@ -1098,6 +1099,31 @@ User statistics update time
| Default is **00:00**. | |
+--------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------+

.. config:setting:: channel-category-sorting
:displayname: Channel category sorting (Users and Teams)
:systemconsole: Site Configuration > Users and Teams
:configjson: .TeamSettings.EnableChannelCategorySorting
:environment: MM_TEAMSETTINGS_ENABLECHANNELCATEGORYSORTING
:description: This setting controls whether channel admins can choose a default sidebar category when creating or editing a channel. Default is **true**.

- **true**: **(Default)** When creating or editing supported channels, channel admins see a **Default category (optional)** field. Members who join the channel see it under that category in their sidebar.
- **false**: The default category selector is hidden.

Channel category sorting
~~~~~~~~~~~~~~~~~~~~~~~~~~~~

From Mattermost v11.8, channel category sorting is enabled by default. When enabled, channel admins can choose a default sidebar category when creating or editing a channel. Channel admins can select an existing category, type a new category name, or clear the default category from channel settings. Members who join the channel see it under that category in their sidebar. When disabled, the default category selector is hidden.

.. list-table::
:widths: 55 45
:header-rows: 0

* - - **true**: **(Default)** When creating or editing supported channels, channel admins see a **Default category (optional)** field. They can select an existing category, enter a new category name, or clear the default category from channel settings. Members who join the channel see it under that category in their sidebar.
- **false**: The default category selector is hidden when creating or editing channels.
- - System Config path: **Site Configuration > Users and Teams**
- ``config.json`` setting: ``TeamSettings`` > ``EnableChannelCategorySorting`` > ``true``
- Environment variable: ``MM_TEAMSETTINGS_ENABLECHANNELCATEGORYSORTING``

----

Notifications
Expand Down Expand Up @@ -2589,6 +2615,34 @@ Member sync batch size

----

Classification Markings
-----------------------

From Mattermost v11.8, system admins can configure classification markings in the System Console by going to **Site Configuration > Classification Markings**.

Classification markings define reusable classification levels that can be displayed as global or channel-level banners in the web and desktop apps. Each classification level includes a name, color, and rank order. You can select a preset, such as US DoD, NATO, UK GSCP, Canada, or Australia PSPF, or define custom classification levels.

.. note::

Classification markings are informational only and aren't tied to access control decisions at this time.

Configure classification markings:

1. Go to **System Console > Site Configuration > Classification Markings**.
2. Enable **Enable classification markings**.
3. Select a **Classification preset**, or create custom classification levels.
4. Configure classification level names, colors, and rank order.
5. Optionally enable the **Global Classification Banner** under **Global Classification Indicators**.
6. Select the **Banner visibility**:

- **Top only**
- **Top and bottom**

7. Select the **Global classification level** to display.
8. Select **Save**.

----

config.json-only settings
-------------------------

Expand Down
Loading