Conversation
Align the docs with the admin console rename from Site Statistics to System Statistics so navigation and delegated-admin guidance match the UI. Preserve the legacy reporting settings anchor so existing deep links continue to resolve. Made-with: Cursor
There was a problem hiding this comment.
Pull request overview
Updates Mattermost documentation to reflect the Admin Console rename from Site Statistics to System Statistics, while preserving legacy deep links for reporting settings.
Changes:
- Renames “Site Statistics” to “System Statistics” across affected docs and guidance.
- Preserves the legacy
site-statisticsanchor in reporting configuration docs for backward-compatible deep links. - Updates delegated-admin privilege labeling and related navigation instructions to match the UI.
Reviewed changes
Copilot reviewed 6 out of 6 changed files in this pull request and generated 4 comments.
Show a summary per file
| File | Description |
|---|---|
| source/product-overview/subscription.rst | Updates the statistics page label referenced in subscription billing guidance. |
| source/product-overview/self-hosted-subscriptions.rst | Updates true-up screenshot instructions to the new System Statistics label. |
| source/administration-guide/onboard/delegated-granular-administration.rst | Updates delegated admin “Reporting” privilege label to “System Statistics”. |
| source/administration-guide/manage/statistics.rst | Renames the “Site statistics” section heading to “System statistics”. |
| source/administration-guide/manage/admin/installing-license-key.rst | Updates license-usage navigation to the new System Statistics label. |
| source/administration-guide/configure/reporting-configuration-settings.rst | Updates the section label and adds legacy site-statistics anchor for deep-link compatibility. |
|
|
||
| Site statistics | ||
| System statistics | ||
| --------------- |
There was a problem hiding this comment.
Editor Evie — Blocker: The section title underline is shorter than the title ("System statistics" / "---------------"), which will cause reStructuredText parsing/build errors. Suggestion: extend the underline to at least the same length as the title (e.g., use 17+ dashes to match "System statistics").
| --------------- | |
| ----------------- |
| .. _site-statistics: | ||
|
|
||
| System statistics | ||
| --------------- |
There was a problem hiding this comment.
Editor Evie — Blocker: The section title underline is shorter than the title ("System statistics" / "---------------"), which will break reStructuredText rendering for this page. Suggestion: extend the underline to at least the title length (17+ dashes).
| --------------- | |
| ----------------- |
| Bots, deactivated users, and synthetic users in :doc:`Microsoft Teams integrations </end-user-guide/collaborate/collaborate-within-connected-microsoft-teams>` and :doc:`connected workspace </administration-guide/onboard/connected-workspaces>` users aren't counted towards the total number of activated users. | ||
|
|
||
| You can review your activated user count in **System Console > Site Statistics** under **Total Activated Users**. Review single-channel guest usage separately under **Single-channel Guests**. | ||
| You can review your activated user count in **System Console > System Statistics** under **Total Activated Users**. Review single-channel guest usage separately under **Single-channel Guests**. |
There was a problem hiding this comment.
Novice Nate — Friction: This navigation path differs from other pages updated in this PR (which use System Console > Reporting > System Statistics). Quoted: "System Console > System Statistics". Why it matters: readers may not find the page if they follow an inconsistent path. Suggestion (minimal): change to System Console > Reporting > System Statistics for consistency with the rest of the docs.
| You can review your activated user count in **System Console > System Statistics** under **Total Activated Users**. Review single-channel guest usage separately under **Single-channel Guests**. | |
| You can review your activated user count in **System Console > Reporting > System Statistics** under **Total Activated Users**. Review single-channel guest usage separately under **Single-channel Guests**. |
| | | - PERMISSION_SYSCONSOLE_WRITE_ABOUT_EDITION_AND_LICENSE | | ||
| +------------------------+--------------------------------------------------------------------------+ | ||
| | Reporting | **Site Statistics** | | ||
| | Reporting | **System Statistics** | |
There was a problem hiding this comment.
Veteran Vince — Friction: The UI label was updated to System Statistics, but the documented permission constants remain "...SITE_STATISTICS". Quoted: "System Statistics" next to "PERMISSION_SYSCONSOLE*_REPORTING_SITE_STATISTICS". Why it matters: admins scripting role changes may assume the permission names were renamed too and have trouble finding the right constants. Suggestion: add a brief note here that the permission constant names retain the legacy "SITE_STATISTICS" wording even though the UI page is now labeled "System Statistics".
| | Reporting | **System Statistics** | | |
| | Reporting | **System Statistics** | | |
| | | Note: Permission constants retain the legacy | | |
| | | ``..._SITE_STATISTICS`` naming. | |
|
Newest code from mattermost has been published to preview environment for Git SHA f13250b |
📝 WalkthroughWalkthroughDocumentation terminology is updated across multiple guide sections, renaming "Site statistics" to "System statistics". Changes include updating section headers, internal anchor labels, navigation paths in user instructions, configuration references, and privilege labels. Changes
Estimated code review effort🎯 1 (Trivial) | ⏱️ ~5 minutes 🚥 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)
Warning Review ran into problems🔥 ProblemsGit: Failed to clone repository. Please run the Comment |
![coderabbitai[bot]](https://avatars.githubusercontent.com/in/347564?s=60&v=4){kind=small}
There was a problem hiding this comment.
Actionable comments posted: 1
🤖 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/subscription.rst`:
- Line 100: Update the navigation path string "System Console > System
Statistics" to include the intermediate Reporting level so it reads "System
Console > Reporting > System Statistics" while keeping the references to "Total
Activated Users" and "Single-channel Guests" unchanged; modify the sentence in
the subscription.rst content that currently contains "System Console > System
Statistics" to the new full path for consistency with other docs.
🪄 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: de75be48-cc32-447e-a1b8-7f3f74097871
📒 Files selected for processing (6)
source/administration-guide/configure/reporting-configuration-settings.rstsource/administration-guide/manage/admin/installing-license-key.rstsource/administration-guide/manage/statistics.rstsource/administration-guide/onboard/delegated-granular-administration.rstsource/product-overview/self-hosted-subscriptions.rstsource/product-overview/subscription.rst
| Bots, deactivated users, and synthetic users in :doc:`Microsoft Teams integrations </end-user-guide/collaborate/collaborate-within-connected-microsoft-teams>` and :doc:`connected workspace </administration-guide/onboard/connected-workspaces>` users aren't counted towards the total number of activated users. | ||
|
|
||
| You can review your activated user count in **System Console > Site Statistics** under **Total Activated Users**. Review single-channel guest usage separately under **Single-channel Guests**. | ||
| You can review your activated user count in **System Console > System Statistics** under **Total Activated Users**. Review single-channel guest usage separately under **Single-channel Guests**. |
There was a problem hiding this comment.
Use the full navigation path for consistency and accuracy.
Line 100 likely omits the intermediate Reporting level. For consistency with the rest of this PR, use System Console > Reporting > System Statistics.
Suggested minimal diff
-You can review your activated user count in **System Console > System Statistics** under **Total Activated Users**. Review single-channel guest usage separately under **Single-channel Guests**.
+You can review your activated user count in **System Console > Reporting > System Statistics** under **Total Activated Users**. Review single-channel guest usage separately under **Single-channel Guests**.Based on learnings: "Describe Mattermost feature behavior, UI labels, and capability boundaries accurately."
📝 Committable suggestion
‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.
| You can review your activated user count in **System Console > System Statistics** under **Total Activated Users**. Review single-channel guest usage separately under **Single-channel Guests**. | |
| You can review your activated user count in **System Console > Reporting > System Statistics** under **Total Activated Users**. Review single-channel guest usage separately under **Single-channel Guests**. |
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.
In `@source/product-overview/subscription.rst` at line 100, Update the navigation
path string "System Console > System Statistics" to include the intermediate
Reporting level so it reads "System Console > Reporting > System Statistics"
while keeping the references to "Total Activated Users" and "Single-channel
Guests" unchanged; modify the sentence in the subscription.rst content that
currently contains "System Console > System Statistics" to the new full path for
consistency with other docs.
Summary
Align the docs with the admin console rename in mattermost/mattermost#36179 from Site Statistics to System Statistics so navigation and delegated-admin guidance match the UI. Preserve the legacy reporting settings anchor so existing deep links continue to resolve.
Ticket Link
https://mattermost.atlassian.net/browse/MM-67511
Made-with: Cursor