Open
Conversation
- Add v6.2 ESR entry to desktop releases table (released 2026-05-16, support ends 2027-05-15) - Add v6.2 changelog section to desktop-app-changelog.md - Update Linux install instructions from v6.1.1 to v6.2.0 - Update MSI installer guide from v6.1.1 to v6.2.0 Resolves #8900 Co-authored-by: Amy Blais <amyblais@users.noreply.github.com>
Contributor
📝 WalkthroughWalkthroughDocumentation updates for Mattermost Desktop v6.2.0 ESR: version references in installers and downloads, updated Chromium-based browser minimums to 146+, and addition of the v6.2 release changelog and release-table entry. Changes
Estimated code review effort🎯 2 (Simple) | ⏱️ ~10 minutes Possibly related PRs
Suggested labels
🚥 Pre-merge checks | ✅ 5✅ Passed checks (5 passed)
✏️ Tip: You can configure your own custom pre-merge checks in the settings. ✨ Finishing Touches🧪 Generate unit tests (beta)
Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out. Comment |
Contributor
There was a problem hiding this comment.
Pull request overview
Updates Mattermost documentation to include the Desktop App v6.2 ESR release information across the releases table, changelog, and platform install guides.
Changes:
- Add a v6.2 (ESR) entry to the Desktop Releases compatibility/support table.
- Add a v6.2 changelog section with download link, compatibility note, and known issues.
- Bump referenced Desktop version strings/URLs in Linux and Windows (MSI/GPO) installation docs to v6.2.0.
Reviewed changes
Copilot reviewed 5 out of 5 changed files in this pull request and generated 4 comments.
| File | Description |
|---|---|
| source/product-overview/mattermost-desktop-releases.md | Adds the v6.2 ESR row with dates, links, and server compatibility refs. |
| source/product-overview/desktop-app-changelog.md | Introduces the v6.2 changelog section (release header, download link, compatibility, known issues). |
| source/deployment-guide/desktop/linux-desktop-install.rst | Updates Linux install/download examples to reference v6.2.0 artifacts. |
| source/deployment-guide/desktop/desktop-msi-installer-and-group-policy-install.rst | Updates Windows MSI/GPO instructions and example commands to v6.2.0. |
Contributor
|
Newest code from mattermost has been published to preview environment for Git SHA 8b504d7 |
Contributor
|
Newest code from mattermost has been published to preview environment for Git SHA 8261ea0 |
Contributor
|
Newest code from mattermost has been published to preview environment for Git SHA c66eb86 |
![coderabbitai[bot]](https://avatars.githubusercontent.com/in/347564?s=60&v=4){kind=small}
Contributor
|
Newest code from mattermost has been published to preview environment for Git SHA aaa77f3 |
amyblais
added
1: Dev Review
Contributor
|
Newest code from mattermost has been published to preview environment for Git SHA ea5e027 |
devinbinnie
approved these changes
Apr 17, 2026
Contributor
|
Newest code from mattermost has been published to preview environment for Git SHA bbd8486 |
Contributor
There was a problem hiding this comment.
Actionable comments posted: 6
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.
Inline comments:
In
`@source/deployment-guide/desktop/desktop-msi-installer-and-group-policy-install.rst`:
- Line 50: Replace the brittle "releases/latest" link with a version-pinned URL
that matches the written text: change the link target that currently points to
`releases/latest` (the sentence containing "version v6.2.0") to the specific
release tag URL for v6.2.0 (e.g. the GitHub release page for v6.2.0) so the link
will not drift when new releases are published.
- Line 218: Make the documentation consistent by either removing the "Replace
<version>" note or by replacing the hardcoded v6.2.0 occurrences with the
<version> placeholder; preferred fix: change the literal "v6.2.0" examples (the
hardcoded version strings) to use "<version>" everywhere and add a single inline
example like "(e.g., v6.2.0)" next to the first occurrence so readers know the
expected format while all commands reference the <version> placeholder.
In `@source/product-overview/desktop-app-changelog.md`:
- Line 14: Replace the brittle GitHub URL that uses "releases/latest" in the
"Download Binaries" link with the stable tag URL for v6.2.0 (change the href
from https://github.com/mattermost/desktop/releases/latest to
https://github.com/mattermost/desktop/releases/tag/v6.2.0) so the changelog
entry for "Download Binaries" always points to the v6.2.0 release.
- Line 18: Replace the hardcoded external URL in the sentence "Desktop App is
supported on any currently supported [Mattermost server
version](https://docs.mattermost.com/product-overview/mattermost-desktop-releases.html#latest-releases)."
with the repo-appropriate internal link syntax used across docs; update the link
target for the link text "Mattermost server version" to point to the internal
docs page (the repo-internal path for the Mattermost desktop releases/Latest
releases anchor) so the Markdown uses the project's internal linking convention
instead of https://docs.mattermost.com.
- Line 60: Update the incorrect cache path examples in the changelog line that
currently mentions Windows as `Users/<username>/AppData/Roaming/Mattermost` and
Linux as `~/config/Mattermost`: change the Windows example to include the
drive/root (e.g., `C:\Users\<username>\AppData\Roaming\Mattermost`) and change
the Linux path to the hidden config location `~/.config/Mattermost` (leave the
macOS path as-is).
In `@source/product-overview/mattermost-desktop-releases.md`:
- Line 21: Update the Released date for Desktop App v6.2 in the table row for
"v6.2" (the line containing the v6.2 release entry) from "Released: 2026-05-15"
to "Released: 2026-05-16" so it matches the release-policy schedule; ensure the
rest of the cell (Support Ends, changelog, SBOM links and release references)
remains unchanged.
🪄 Autofix (Beta)
Fix all unresolved CodeRabbit comments on this PR:
- Push a commit to this branch (recommended)
- Create a new PR with the fixes
ℹ️ Review info
⚙️ Run configuration
Configuration used: Organization UI
Review profile: CHILL
Plan: Pro
Run ID: a69cf909-dd1b-4de4-aa10-c99963e81ab8
📒 Files selected for processing (5)
source/deployment-guide/desktop/desktop-msi-installer-and-group-policy-install.rstsource/deployment-guide/desktop/linux-desktop-install.rstsource/deployment-guide/software-hardware-requirements.rstsource/product-overview/desktop-app-changelog.mdsource/product-overview/mattermost-desktop-releases.md
Contributor
|
Newest code from mattermost has been published to preview environment for Git SHA 8a8509f |
Contributor
|
Newest code from mattermost has been published to preview environment for Git SHA 4c81681 |
amyblais
requested review from
caseysoftware
and removed request for
caseysoftware
Contributor
There was a problem hiding this comment.
Actionable comments posted: 1
♻️ Duplicate comments (3)
source/product-overview/desktop-app-changelog.md (3)
18-18:⚠️ Potential issue | 🟡 MinorUse repo-internal link syntax for the server compatibility link.
Line 18 hardcodes a
docs.mattermost.comURL for an internal page.Suggested minimal fix
-- Desktop App is supported on any currently supported [Mattermost server version](https://docs.mattermost.com/product-overview/mattermost-desktop-releases.html#latest-releases). +- Desktop App is supported on any currently supported [Mattermost server version](mattermost-desktop-releases.md#latest-releases).Based on learnings: "Internal links to Mattermost docs should use repo-appropriate internal link syntax instead of hardcoded
https://docs.mattermost.com/...URLs."🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed. In `@source/product-overview/desktop-app-changelog.md` at line 18, Replace the hardcoded external docs.mattermost.com URL in the sentence "Desktop App is supported on any currently supported [Mattermost server version](https://docs.mattermost.com/product-overview/mattermost-desktop-releases.html#latest-releases)." with the repo's internal link syntax for the server compatibility page (use the project’s relative/internal markdown link format used elsewhere in the docs), ensuring the link target points to the same "product-overview/mattermost-desktop-releases.html#latest-releases" anchor and preserving the link text "Mattermost server version".
14-14:⚠️ Potential issue | 🟠 MajorPin the download URL to the v6.2.0 tag.
Line 14 uses
releases/latest, which will drift away from this versioned changelog entry.Suggested minimal fix
-**Download Binaries:** [Mattermost Desktop on GitHub](https://github.com/mattermost/desktop/releases/latest) +**Download Binaries:** [Mattermost Desktop on GitHub](https://github.com/mattermost/desktop/releases/tag/v6.2.0)As per coding guidelines: "When a docs link is broken, brittle, or non-standard, explain the issue briefly and provide the smallest correct replacement."
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed. In `@source/product-overview/desktop-app-changelog.md` at line 14, The download link currently uses the floating "releases/latest" URL; update the Markdown line containing "Download Binaries:" so it points to the fixed v6.2.0 tag URL (replace https://github.com/mattermost/desktop/releases/latest with https://github.com/mattermost/desktop/releases/tag/v6.2.0) to pin this changelog entry to the specific release.
61-61:⚠️ Potential issue | 🟠 MajorCorrect the cache path examples for Windows and Linux.
Line 61 currently gives misleading filesystem paths for Windows and Linux.
Suggested minimal fix
-- Users seeing an endless "Loading..." screen when attempting to log in to the app may need to manually delete their cache directory. For macOS it is located in `/Users/<username>/Library/Containers/Mattermost/Data/Library/Application Support/Mattermost`, for Windows in `Users/<username>/AppData/Roaming/Mattermost` and for Linux in `~/config/Mattermost` (where `~` is the home directory). +- Users seeing an endless "Loading..." screen when attempting to log in to the app may need to manually delete their cache directory. For macOS it is located in `/Users/<username>/Library/Containers/Mattermost/Data/Library/Application Support/Mattermost`, for Windows in `C:\Users\<username>\AppData\Roaming\Mattermost`, and for Linux in `~/.config/Mattermost` (where `~` is the home directory).As per coding guidelines: "Flag commands, settings, prerequisites, or sequencing that are misleading, incomplete, or unlikely to work as written."
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed. In `@source/product-overview/desktop-app-changelog.md` at line 61, Update the misleading cache path examples in the markdown: replace the Windows path "Users/<username>/AppData/Roaming/Mattermost" with the standard %APPDATA%\Mattermost notation (or Users\<username>\AppData\Roaming\Mattermost if keeping explicit user paths) and correct the Linux path from "~/config/Mattermost" to the proper "~/.config/mattermost" (lowercase and with a leading dot). Ensure the macOS example "/Users/<username>/Library/Containers/Mattermost/Data/Library/Application Support/Mattermost" remains unchanged.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.
Inline comments:
In `@source/product-overview/desktop-app-changelog.md`:
- Line 60: Update the typo in the installer warning message by changing the
shortcut filename string "Mattermost.Ink" to the correct Windows shortcut
extension "Mattermost.lnk" in the document content that contains the text
"Warning 1946. Property 'System.AppUserModel.ID' for shortcut 'Mattermost.Ink'
could not be set".
---
Duplicate comments:
In `@source/product-overview/desktop-app-changelog.md`:
- Line 18: Replace the hardcoded external docs.mattermost.com URL in the
sentence "Desktop App is supported on any currently supported [Mattermost server
version](https://docs.mattermost.com/product-overview/mattermost-desktop-releases.html#latest-releases)."
with the repo's internal link syntax for the server compatibility page (use the
project’s relative/internal markdown link format used elsewhere in the docs),
ensuring the link target points to the same
"product-overview/mattermost-desktop-releases.html#latest-releases" anchor and
preserving the link text "Mattermost server version".
- Line 14: The download link currently uses the floating "releases/latest" URL;
update the Markdown line containing "Download Binaries:" so it points to the
fixed v6.2.0 tag URL (replace
https://github.com/mattermost/desktop/releases/latest with
https://github.com/mattermost/desktop/releases/tag/v6.2.0) to pin this changelog
entry to the specific release.
- Line 61: Update the misleading cache path examples in the markdown: replace
the Windows path "Users/<username>/AppData/Roaming/Mattermost" with the standard
%APPDATA%\Mattermost notation (or Users\<username>\AppData\Roaming\Mattermost if
keeping explicit user paths) and correct the Linux path from
"~/config/Mattermost" to the proper "~/.config/mattermost" (lowercase and with a
leading dot). Ensure the macOS example
"/Users/<username>/Library/Containers/Mattermost/Data/Library/Application
Support/Mattermost" remains unchanged.
🪄 Autofix (Beta)
Fix all unresolved CodeRabbit comments on this PR:
- Push a commit to this branch (recommended)
- Create a new PR with the fixes
ℹ️ Review info
⚙️ Run configuration
Configuration used: Organization UI
Review profile: CHILL
Plan: Pro
Run ID: 76da71ee-d14b-41d2-96df-fee7a51b9d73
📒 Files selected for processing (3)
source/deployment-guide/desktop/desktop-msi-installer-and-group-policy-install.rstsource/product-overview/desktop-app-changelog.mdsource/product-overview/mattermost-desktop-releases.md
✅ Files skipped from review due to trivial changes (2)
- source/product-overview/mattermost-desktop-releases.md
- source/deployment-guide/desktop/desktop-msi-installer-and-group-policy-install.rst
Contributor
|
Newest code from mattermost has been published to preview environment for Git SHA 949dc81 |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Resolves #8900
Generated with Claude Code