-
Notifications
You must be signed in to change notification settings - Fork 609
Document single-channel guest licensing changes #8810
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.
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
Changes from all commits
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
| Original file line number | Diff line number | Diff line change | ||||
|---|---|---|---|---|---|---|
|
|
@@ -26,7 +26,8 @@ Site statistics | |||||
| .. note:: | ||||||
|
|
||||||
| - Bots, deactivated users, and synthetic users in :doc:`Microsoft Teams integrations </end-user-guide/collaborate/collaborate-within-connected-microsoft-teams>` and :doc:`connected workspaces </administration-guide/onboard/connected-workspaces>` users aren't counted towards the total number of activated users. | ||||||
| - For billing purposes, activated guest accounts do consume a licensed seat, which is returned when the guest account is deactivated. This means that guest accounts count as a paid user in your Mattermost :doc:`workspace </end-user-guide/end-user-guide-index>` | ||||||
| - **Single-channel Guests** shows the number of active guest accounts that belong to exactly one channel. Direct messages and group messages don't affect whether a guest is counted as a single-channel guest. Single-channel guests are counted separately from the primary paid seat count and are free up to a 1:1 ratio with licensed seats. When this count exceeds the allowance, the statistic is highlighted as a warning for system admins. | ||||||
| - Guests in multiple channels continue to count as paid active users. See the :doc:`guest accounts </administration-guide/onboard/guest-accounts>` documentation for details. | ||||||
|
||||||
| - Guests in multiple channels continue to count as paid active users. See the :doc:`guest accounts </administration-guide/onboard/guest-accounts>` documentation for details. | |
| - Guests in multiple channels continue to count as activated users (for billing). See the :doc:`guest accounts </administration-guide/onboard/guest-accounts>` documentation for details. |
| Original file line number | Diff line number | Diff line change | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|
|
|
@@ -12,7 +12,7 @@ Guest accounts in Mattermost are a way to collaborate with individuals, such as | |||||||||
|
|
||||||||||
| - A system admin must :ref:`enable guest access <administration-guide/configure/authentication-configuration-settings:guest access>` before guests can be invited. | ||||||||||
| - Mattermost Enterprise and Professional customers can :doc:`control who can invite guests </administration-guide/onboard/advanced-permissions>` in their organization. By default, only system admins can invite guests. | ||||||||||
| - Guest accounts count as a paid user in your Mattermost :doc:`workspace </end-user-guide/end-user-guide-index>`. However, guests aren't automatically added to the default **Town-square** channel when they log in. You must :doc:`invite guests </end-user-guide/collaborate/invite-people>` to individual teams and channels manually. Deactivating a guest account reduces your licensed seat count. | ||||||||||
| - Guest accounts don't all consume a licensed seat in the same way. Guests in exactly one channel are treated as single-channel guests and don't count toward the primary paid seat count. They're free up to a 1:1 ratio with licensed seats. Guests in multiple channels continue to count as paid active users. Direct messages and group messages don't affect whether a guest is counted as a single-channel guest. | ||||||||||
|
||||||||||
| - Guest accounts don't all consume a licensed seat in the same way. Guests in exactly one channel are treated as single-channel guests and don't count toward the primary paid seat count. They're free up to a 1:1 ratio with licensed seats. Guests in multiple channels continue to count as paid active users. Direct messages and group messages don't affect whether a guest is counted as a single-channel guest. | |
| - Guest accounts don't all consume a licensed seat in the same way. Guests in exactly one channel are treated as single-channel guests and don't count toward the primary paid seat count. They're free up to a 1:1 ratio with licensed seats. Guests in multiple channels continue to count as activated users for billing. Direct messages and group messages don't affect whether a guest is counted as a single-channel guest. |
Copilot
AI
Apr 16, 2026
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Novice Nate — Blocker: The emphasis markup in "Channels that contain guests also display the message *This channel has guests" is unbalanced (3 asterisks opening vs 2 closing), which will render incorrectly in the published docs. Change it to balanced markup (for example, bold the message text consistently).
| - You'll identify guest users in Mattermost based on their **GUEST** badge next to their name and profile picture. Channels that contain guests also display the message ***This channel has guests** in the channel header. | |
| - You'll identify guest users in Mattermost based on their **GUEST** badge next to their name and profile picture. Channels that contain guests also display the message **This channel has guests** in the channel header. |
Copilot
AI
Apr 16, 2026
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Novice Nate — Friction: The FAQ question "Why doesn’t Mattermost have single-channel guests?" now contradicts the updated answer immediately below ("Mattermost now supports single-channel guests."). Rename the question to match the new reality (for example, "Does Mattermost support single-channel guests?" or "How do single-channel guests work?") so readers don’t think the feature is unavailable.
| Why doesn’t Mattermost have single-channel guests? | |
| ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | |
| Does Mattermost support single-channel guests? | |
| ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
| Original file line number | Diff line number | Diff line change | ||||
|---|---|---|---|---|---|---|
|
|
@@ -182,7 +182,7 @@ | |||||
| <td></td><td><img src="../_static/images/check-circle-green.svg">*</td><td><img src="../_static/images/check-circle-green.svg"></td><td><img src="../_static/images/check-circle-green.svg"></td><td><img src="../_static/images/check-circle-green.svg"></td><td>v9.11+</td> | ||||||
| </tr> | ||||||
| <tr> | ||||||
| <td><strong>Guest accounts</strong>: Bring external users and users who need to have restricted access into your Mattermost instance as <a href="https://docs.mattermost.com/administration-guide/onboard/guest-accounts.html">guests</a> who can interact with your team with <a href="https://docs.mattermost.com/administration-guide/onboard/guest-accounts.html#guests-account-limits">limited permissions</a>. Activated guest accounts consume a <a href="https://docs.mattermost.com/administration-guide/onboard/guest-accounts.html#how-am-i-charged-for-guest-accounts">licensed seat</a> for billing purposes, which is returned when the guest account is deactivated.</td> | ||||||
| <td><strong>Guest accounts</strong>: Bring external users and users who need to have restricted access into your Mattermost instance as <a href="https://docs.mattermost.com/administration-guide/onboard/guest-accounts.html">guests</a> who can interact with your team with <a href="https://docs.mattermost.com/administration-guide/onboard/guest-accounts.html#guests-account-limits">limited permissions</a>. Guests in exactly one channel are treated as single-channel guests and are free up to a 1:1 ratio with licensed seats. Guests in multiple channels continue to count as paid active users. Direct messages and group messages do not affect whether a guest is counted as a single-channel guest.</td> | ||||||
|
||||||
| <td><strong>Guest accounts</strong>: Bring external users and users who need to have restricted access into your Mattermost instance as <a href="https://docs.mattermost.com/administration-guide/onboard/guest-accounts.html">guests</a> who can interact with your team with <a href="https://docs.mattermost.com/administration-guide/onboard/guest-accounts.html#guests-account-limits">limited permissions</a>. Guests in exactly one channel are treated as single-channel guests and are free up to a 1:1 ratio with licensed seats. Guests in multiple channels continue to count as paid active users. Direct messages and group messages do not affect whether a guest is counted as a single-channel guest.</td> | |
| <td><strong>Guest accounts</strong>: Bring external users and users who need to have restricted access into your Mattermost instance as <a href="/administration-guide/onboard/guest-accounts.html">guests</a> who can interact with your team with <a href="/administration-guide/onboard/guest-accounts.html#guests-account-limits">limited permissions</a>. Guests in exactly one channel are treated as single-channel guests and are free up to a 1:1 ratio with licensed seats. Guests in multiple channels continue to count as paid active users. Direct messages and group messages do not affect whether a guest is counted as a single-channel guest.</td> |
| Original file line number | Diff line number | Diff line change | ||||
|---|---|---|---|---|---|---|
|
|
@@ -38,16 +38,18 @@ Quarterly true-up reports | |||||
|
|
||||||
| When you buy an annual Mattermost subscription, you agree to provide Mattermost with quarterly reports of the actual number of activated users within your system. An activated user is a user who has a Mattermost account and doesn't show as **Deactivated** in **System Console > User Management > Users**. | ||||||
|
|
||||||
| Single-channel guests are tracked separately from activated users. Guests in exactly one channel are free up to a 1:1 ratio with licensed seats, while guests in multiple channels continue to count as activated users. Direct messages and group messages don't affect whether a guest is counted as a single-channel guest. | ||||||
|
|
||||||
| We'll send you an email notice around the end of the quarter reminding you to send us your report. | ||||||
|
|
||||||
| .. image:: ../images/true-up-schedule.png | ||||||
| :alt: The timeframes followed for the true-up notifications. | ||||||
|
|
||||||
| If you have more total activated users than you purchased in your annual subscription, your Customer Success Manager will provide you with a true-up quote for the new users added. The additional invoice will be pro-rated based on the number of months left in your subscription term, including the months for the calendar quarter for the time you pull the report. Mattermost won't provide downward adjustments. Mattermost will invoice based on Mattermost’s `current list prices <https://mattermost.com/pricing/>`_. | ||||||
|
|
||||||
| A system admin must take a screenshot of the **System Console > Site Statistics** page and send it to Mattermost in an email. | ||||||
| A system admin must take a screenshot of the **System Console > Reporting > Site Statistics** page and send it to Mattermost in an email. | ||||||
|
|
||||||
| - Please ensure your screenshot is taken from the top of the page and includes both **Total Activated Users** and the **Monthly Active Users** metrics. | ||||||
| - Please ensure your screenshot is taken from the top of the page and includes **Total Activated Users**, **Single-channel Guests**, and **Monthly Active Users**. | ||||||
|
||||||
| - Please ensure your screenshot is taken from the top of the page and includes **Total Activated Users**, **Single-channel Guests**, and **Monthly Active Users**. | |
| - Please ensure your screenshot is taken from the top of the page and includes **Total Activated Users**, **Single-channel Guests**, and **Monthly Active Users**. |
Copilot
AI
Apr 16, 2026
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Editor Evie — Friction: Wording/spacing: "over estimate/charge" should be a single word ("overestimate") to avoid reading as two separate actions and to match standard usage.
| As your organization grows, you may need to add additional users during your subscription period. Mattermost needs to have insight into changes in your activated user count so that we can charge you appropriately for your self-hosted license usage. Additionally, we don’t want to over estimate/charge activated users at your renewal time. | |
| As your organization grows, you may need to add additional users during your subscription period. Mattermost needs to have insight into changes in your activated user count so that we can charge you appropriately for your self-hosted license usage. Additionally, we don’t want to overestimate or overcharge activated users at your renewal time. |
Copilot
AI
Apr 16, 2026
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Editor Evie — Polish: Hyphenation reads like a compound modifier here ("system-admin warnings") but elsewhere in the docs this role is written as "system admins". Consider changing to "system admin warnings" or rephrasing (e.g., "warnings visible to system admins") for consistency.
| Single-channel guests are visible separately in reporting and on the **Edition and License** page. They don't count toward the primary paid seat count up to a 1:1 ratio with licensed seats, and exceeding that allowance generates system-admin warnings rather than hard limits. | |
| Single-channel guests are visible separately in reporting and on the **Edition and License** page. They don't count toward the primary paid seat count up to a 1:1 ratio with licensed seats, and exceeding that allowance generates system admin warnings rather than hard limits. |
| Original file line number | Diff line number | Diff line change | ||||
|---|---|---|---|---|---|---|
|
|
@@ -87,11 +87,17 @@ In this case, the "physical address" is the location where the individual, who w | |||||
| How is a user defined for subscriptions? | ||||||
| ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | ||||||
|
|
||||||
| For the purpose of billing, a “user” is any account created in Mattermost that does not show as **Deactivated** in **System Console > User Management > Users**. Guests are also defined as users. | ||||||
| For the purpose of billing, an activated user is any account created in Mattermost that does not show as **Deactivated** in **System Console > User Management > Users**. | ||||||
|
|
||||||
| Guests are billed based on channel access: | ||||||
|
|
||||||
| - Guests in exactly one channel are treated as single-channel guests. They don't count toward the primary paid seat count and are free up to a 1:1 ratio with licensed seats. | ||||||
| - Guests in multiple channels continue to count as activated users for billing purposes. | ||||||
| - Direct messages and group messages don't affect whether a guest is counted as a single-channel guest. | ||||||
|
|
||||||
| 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 user count, for billing purposes, by going to **System Console > Site Statistics**, under **Total 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 > 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 > Reporting > Site Statistics** under **Total Activated Users**. Review single-channel guest usage separately under **Single-channel Guests**. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Novice Nate — Friction: Terminology: "paid active users" is introduced here without context, while admins will typically see "activated users" / Total Activated Users in the System Console and billing docs. Consider switching this to "activated users (for billing)" to reduce ambiguity.