Skip to content

MM-67771: Update Report a Problem default behavior docs #8845

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
vish9812 wants to merge 3 commits into
base: master
Choose a base branch
from
+3 −3
Open

MM-67771: Update Report a Problem default behavior docs #8845

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
4a5b018
MM-67771: Update Report a Problem docs to reflect email flow
vish9812 Apr 1, 2026
d1c2e7c
Update site-configuration-settings.rst
esethna Apr 13, 2026
9999eb3
Merge branch 'master' into MM-67771-report-a-problem-docs
vish9812 Apr 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
6 changes: 3 additions & 3 deletions source/administration-guide/configure/site-configuration-settings.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -253,7 +253,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>`_.
Copy link

Copilot AI Apr 24, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

(Editor Evie, Friction) In the type list, the label changed from Default link to Default. Unless the System Console option label also changed, this makes the docs harder to match/search against the UI. Also, “open a support case by email” is a bit ambiguous—consider wording that explicitly says it opens the user’s default email client/composer to contact Mattermost Support (and that unlicensed deployments are directed to the troubleshooting forums).

Suggested change
- **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>`_.
- **Default link**: Customers with a Mattermost license can open their default email client or composer to contact Mattermost Support. Unlicensed Mattermost deployments are directed to the `troubleshooting forums <https://mattermost.com/pl/report_a_problem_unlicensed>`_.

Copilot uses AI. Check for mistakes.
- **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 +282,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 +291,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
Loading