Update Desktop App user settings and email link actions

[Combs7th]

@claude - Please review the following Mattermost Desktop engineering PRs for product documentation impact:

mattermost/desktop#3672
mattermost/desktop#3777

Goal:
Draft a minimal Mattermost Product Documentation update for end-user Desktop App behavior/settings from Mattermost Desktop v6.2.0 onward.

Scope:

• End-user-facing docs only.
• Focus on what users can now do.
• Do not document implementation details, code paths, tests, or internal Electron behavior.
• Do not modify changelogs, upgrade notes, version archive, deprecated/removed feature pages, or unsupported-release docs.
• Use the PR milestone version if present. If no milestone is present, mark the version as: [NOT PRESENT IN PR — REQUIRES HUMAN JUDGMENT].

Likely doc touchpoint:

• Desktop App customization/preferences docs, likely:
  source/end-user-guide/preferences/customize-desktop-app-experience.rst

Required updates:

1. Add the Linux-only Desktop App setting for using native window decorations / native title bar.

   • Mention that users must restart the Desktop App for the setting to apply, if supported by PR evidence.
   • Only mention the Alt-key access behavior for popout menus if it is clearly present in the PR.

2. Add the new right-click context menu option for mailto links.

   • Users can right-click a mailto link and select Copy Email Address.
   • The copied value should be the email address only, without the mailto: prefix or query parameters, if supported by PR evidence.

Required output:

1. Confirm the exact PR evidence that supports each docs update.
2. Identify the exact docs page/file to update.
3. Provide a ready-to-apply docs patch or before/after copy.
4. Keep the update short and user-facing.
5. Explicitly flag anything not present in the PRs as: [NOT PRESENT IN PR — REQUIRES HUMAN JUDGMENT].

[claude]

Claude finished @Combs7th's task in 3m 40s —— View job • claude/issue-8961-20260512-1626 • Create PR ➔

---

Task progress

• Review PR [MM-60442] Add setting to enable native window decorations on Linux desktop#3672 for end-user-facing changes
• Review PR [MM-68285] Add a Copy Email Address menu item for mailto: links desktop#3777 for end-user-facing changes
• Identify PR milestones / target version
• Read current source/end-user-guide/preferences/customize-desktop-app-experience.rst
• Draft minimal docs patch (Linux native title bar + Copy Email Address)
• Apply patch, commit, and push to branch

---

⚠️ Important caveat — PR evidence was NOT directly verified

The sandbox blocked outbound network access to github.com/mattermost/desktop, so I could not open PRs #3672 and #3777 directly. The wording below was drafted from your description of the PRs in the issue body. Please verify against the actual PR diffs before merging — I have flagged every uncertain detail explicitly.

Specific things a human reviewer must verify:

Detail	Source	Action
Exact setting label (Use native window decorations)	guessed from issue body	Match to the literal UI string in PR #3672
"Restart the desktop app to apply" requirement	inferred from issue body	Remove the sentence if PR #3672 doesn't require a restart
Milestone / version (v[NOT PRESENT IN PR — REQUIRES HUMAN JUDGMENT])	placeholder	Replace with PR milestone (or PR's target release) for both bullets
Alt-key access for popout menus	intentionally omitted	Add a sentence only if PR #3672 explicitly documents Alt-key behavior
Copy Email Address label	from issue body	Match literal label in PR #3777
"without the mailto: prefix or query parameters"	from issue body	Confirm against PR #3777's tests/strip logic

Files changed

• source/end-user-guide/preferences/customize-desktop-app-experience.rst (+6 / –0)

Update #1 — Linux native title bar setting (PR #3672)

Added to the Windows/Linux → General list (after Maximum number of open views):

• Use native window decorations (Linux only): From Mattermost Desktop v[NOT PRESENT IN PR — REQUIRES HUMAN JUDGMENT], render the desktop app with your Linux desktop environment's native title bar and window controls instead of the custom Mattermost title bar. Restart the desktop app to apply changes to this setting.

Notes:

• Added inside the existing Windows/Linux tab to avoid restructuring the page; "(Linux only)" annotation makes the platform scope explicit.
• Alt-key popout-menu behavior was not added — per the issue, only include if "clearly present in the PR," and I cannot confirm.

Update #2 — Copy Email Address right-click action (PR #3777)

Added a new top-level section after the tab block:

Right-click context menu actions

• Copy Email Address: From Mattermost Desktop v[NOT PRESENT IN PR — REQUIRES HUMAN JUDGMENT], right-click a mailto: link in any message and select Copy Email Address to copy just the email address to your clipboard, without the mailto: prefix or any query parameters.

Notes:

• Placed outside the macOS / Windows-Linux tabs because right-click context menus apply on all platforms — confirm this is true of PR Update mobile-faq.rst title #3777 before merging.

Commit

6f67777 — Document Linux native title bar setting and mailto context menu action (on branch claude/issue-8961-20260512-1626).

· Branch: claude/issue-8961-20260512-1626

[Combs7th]

@claude - Evidence for docs PR: Update Desktop App user settings and email link actions

Engineering PRs reviewed:

• [MM-60442] Add setting to enable native window decorations on Linux desktop#3672
• [MM-68285] Add a Copy Email Address menu item for mailto: links desktop#3777

First-supported Desktop version:
Mattermost Desktop v6.2.0 for both updates.
Evidence:

• PR Update license-and-subscription.rst #3672 milestone is v6.2.0.
• PR Update mobile-faq.rst title #3777 milestone is v6.2.0.

Update #1 — Linux native title bar setting

PR title:
MM-60442 Add setting to enable native window decorations on Linux

PR summary:
This PR adds a Linux Desktop App setting that lets users use their window manager’s native window decorations instead of Electron-provided decorations. Users enable it from the General tab of Desktop App settings using the "Use native title bar" setting, then restart the Desktop App for the change to apply. The PR also notes that the 3-dot menu on popouts is hidden and must be toggled with Alt.

Literal UI strings:

• "Use native title bar"
• "If enabled, the app will use the native title bar"

Evidence:

• PR summary says users can toggle Use native title bar in the General tab and restart the app to see their window manager’s native title bar.
• i18n/en.json adds:
  • renderer.components.settingsPage.useNativeTitleBar: "Use native title bar"
  • renderer.components.settingsPage.useNativeTitleBar.description: "If enabled, the app will use the native title bar"
• Tests confirm Linux-specific behavior:
  • when useNativeTitleBar is true on Linux, the app uses frame: true and titleBarStyle: "default"
  • when useNativeTitleBar is false on Linux, the app uses the custom title bar
  • useNativeTitleBar is ignored on non-Linux platforms

Doc-ready note:
From Mattermost Desktop v6.2.0, Linux users can enable Use native title bar in Settings > General to use their Linux desktop environment’s native title bar and window controls. Restart the Desktop App to apply the change.

Optional note:
The PR explicitly says the 3-dot menu on popouts is hidden and must be toggled using Alt. Include this only if the docs team agrees it is useful enough for end-user docs.

Update #2 — Copy Email Address context menu action

PR title:
MM-68285 Add a Copy Email Address menu item for mailto: links

PR summary:
This PR adds a "Copy Email Address" option to the right-click context menu for mailto links in the Desktop App. Previously, right-clicking a mailto link only offered "Copy Link", which copied the full mailto URL. The new action copies only the email address, without the mailto: prefix or query parameters.

Literal UI string:

• "Copy Email Address"

Evidence:

• PR summary says the context menu appears when right-clicking a mailto: link and copies just the email address without the mailto: prefix or query parameters.
• Release note says: Added a "Copy Email Address" option to the right-click context menu for mailto links.
• i18n/en.json adds:
  • app.menus.contextMenu.copyEmailAddress: "Copy Email Address"
• Tests confirm:
  • non-mailto links do not show the new item
  • mailto:user@example.com shows "Copy Email Address"
  • clicking it writes "user@example.com" to the clipboard
  • mailto links with query parameters return only the email address
  • MAILTO prefix is case-insensitive
  • control characters are stripped

Doc-ready note:
From Mattermost Desktop v6.2.0, right-click a mailto: link and select Copy Email Address to copy only the email address to your clipboard, without the mailto: prefix or query parameters.

Placement recommendation:
source/end-user-guide/preferences/customize-desktop-app-experience.rst

Suggested validation notes:

• The Linux setting belongs in the existing Windows/Linux Desktop App settings list.
• The Copy Email Address action can be placed in a small Desktop App context menu section.
• Do not describe the internal utility function, tests, Electron behavior, or implementation details.

[claude]

Claude finished @Combs7th's task in 1m 45s —— View job • claude/issue-8961-20260512-1641 • Create PR ➔

---

Docs update applied with verified PR evidence

Thanks for the verified evidence — applied with the corrections to label, version, and placement.

• Read current source/end-user-guide/preferences/customize-desktop-app-experience.rst
• Use the verified UI label Use native title bar (not "Use native window decorations")
• Set version to v6.2.0 for both bullets (replaces [NOT PRESENT IN PR — REQUIRES HUMAN JUDGMENT] placeholders)
• Keep "Restart the desktop app to apply changes to this setting" (confirmed by PR Update license-and-subscription.rst #3672)
• Keep Alt-key popout note omitted (per your "optional, only if docs team agrees" guidance)
• Place Copy Email Address in a new top-level Right-click context menu actions section (cross-platform)
• Commit and push to claude/issue-8961-20260512-1641

---

Files changed

source/end-user-guide/preferences/customize-desktop-app-experience.rst (+6 / -0)

Diff

@@ Windows/Linux > General @@
   - **Maximum number of open views**: ...
+  - **Use native title bar** (Linux only): From Mattermost Desktop v6.2.0, render the desktop app with your Linux desktop environment's native title bar and window controls instead of the custom Mattermost title bar. Restart the desktop app to apply changes to this setting.

@@ end of file (new top-level section) @@
+Right-click context menu actions
+--------------------------------
+
+- **Copy Email Address**: From Mattermost Desktop v6.2.0, right-click a ``mailto:`` link in any message and select **Copy Email Address** to copy just the email address to your clipboard, without the ``mailto:`` prefix or any query parameters.

Evidence mapping

Doc claim	PR evidence
Label = Use native title bar	PR #3672 — renderer.components.settingsPage.useNativeTitleBar: "Use native title bar"
Linux-only behavior	PR #3672 tests — useNativeTitleBar ignored on non-Linux
Restart required	PR #3672 summary — "restart the Desktop App for the change to apply"
Version v6.2.0	PR #3672 milestone
Label = Copy Email Address	PR #3777 — app.menus.contextMenu.copyEmailAddress: "Copy Email Address"
Strips mailto: prefix + query params	PR #3777 tests — query-param + case-insensitive prefix tests
Version v6.2.0	PR #3777 milestone

Intentionally omitted

• Alt-key popout 3-dot menu toggle — present in PR Update license-and-subscription.rst #3672 but you flagged it as discretionary ("include only if the docs team agrees"). Easy to add as a follow-up bullet if the docs team confirms it's useful for end-users.

Commit

aaa761d — Document Linux native title bar setting and mailto Copy Email Address

---

• Branch: claude/issue-8961-20260512-1641