Skip to content

v11.3: Burn on Read docs#8637

Merged
cwarnermm merged 11 commits intomasterfrom
claude/issue-8631-20260115-2204
Jan 22, 2026
Merged

v11.3: Burn on Read docs#8637
cwarnermm merged 11 commits intomasterfrom
claude/issue-8631-20260115-2204

Conversation

@cwarnermm
Copy link
Member

Add complete documentation for the new Burn on Read messaging feature based on Engineering PRs.

This PR includes:

Admin Documentation:

  • System Console settings for Burn on Read configuration
  • Feature flag documentation (MM_FEATUREFLAGS_BURNONREAD)
  • Enterprise Advanced licensing requirements
  • User and group permission controls

End User Documentation:

  • Web and mobile usage instructions
  • Message lifecycle states (concealed → revealed → expired)
  • Platform-specific limitations and differences
  • Explicit warnings about irreversible behavior

Addresses issue #8631

Generated with Claude Code

This commit adds complete documentation for the new Burn on Read messaging feature based on the Engineering PRs. The documentation covers:

Admin Documentation:
- System Console settings for enabling/disabling Burn on Read
- Default burn duration configuration
- User and group permission controls
- Enterprise Advanced licensing requirements
- Feature flag documentation (MM_FEATUREFLAGS_BURNONREAD)

End User Documentation:
- How to send burn-on-read messages (web and mobile)
- Message lifecycle states (concealed → revealed → expired)
- Platform-specific limitations and differences
- Explicit warnings about irreversible behavior
- Mobile-specific restrictions (no replies, threads, limited actions)

Key Features Documented:
- Messages remain concealed until recipients reveal them
- Automatic expiration after specified burn duration
- Irreversible reveal and burn behavior
- Action restrictions (no replies, edits, threads)
- Enterprise Advanced licensing gating
- Server-side enforcement boundaries

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-authored-by: Carrie Warner (Mattermost) <cwarnermm@users.noreply.github.com>
@github-actions
Copy link
Contributor

Newest code from mattermost has been published to preview environment for Git SHA 187ed14

@cwarnermm cwarnermm added 1: Dev Review Requires review by a core commiter Guidance labels Jan 16, 2026
@cwarnermm cwarnermm requested a review from pvev January 16, 2026 19:09
@github-actions
Copy link
Contributor

Newest code from mattermost has been published to preview environment for Git SHA 3d1976b

@github-actions
Copy link
Contributor

Newest code from mattermost has been published to preview environment for Git SHA 7543343

@cwarnermm
Copy link
Member Author

@BillAnderson304 - Do we want to publish burn on read details targeted at risk assessors in the Security Guide?

Copy link
Contributor

@pvev pvev left a comment

Choose a reason for hiding this comment

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

thanks @cwarnermm , some questions and request:

  • we need to explicitly mention this needs enterprise advance license.
  • the docs say the feature flag must be manually enabled, but it is already enabled by default. The note should be clarified this is only needed if its explicitly disabled.

@cwarnermm cwarnermm requested a review from pvev January 19, 2026 14:12
@github-actions
Copy link
Contributor

Newest code from mattermost has been published to preview environment for Git SHA 8dcbfef

@github-actions
Copy link
Contributor

Newest code from mattermost has been published to preview environment for Git SHA cd6a92e

@github-actions
Copy link
Contributor

Newest code from mattermost has been published to preview environment for Git SHA e7e5b5b

@github-actions
Copy link
Contributor

Newest code from mattermost has been published to preview environment for Git SHA be98229

Copy link
Contributor

@pvev pvev left a comment

Choose a reason for hiding this comment

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

thanks @cwarnermm

@github-actions
Copy link
Contributor

Newest code from mattermost has been published to preview environment for Git SHA e72fb64

:description: Controls whether users can send burn-on-read messages. Default is **false**.

- **true**: Users can send burn-on-read messages in channels, direct messages, and group messages.
- **false**: **(Default)** The option to send a burn-on-read message isn't available.
Copy link
Member

Choose a reason for hiding this comment

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

Can we add that disabling the feature doesn't affect existing BoR messages? Receipts can still reveal and burn them.


.. tab:: Mobile

1. Tap the message field and type your message.
Copy link
Member

Choose a reason for hiding this comment

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

The option to create burn on read messages is not available on mobile as of v11.3 release. Users can, however, receive and interact with bor messages.

@github-actions
Copy link
Contributor

Newest code from mattermost has been published to preview environment for Git SHA 6a1e99d

@github-actions
Copy link
Contributor

Newest code from mattermost has been published to preview environment for Git SHA 0104fc4

Copy link
Member

@harshilsharma63 harshilsharma63 left a comment

Choose a reason for hiding this comment

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

Looks good!

@cwarnermm cwarnermm added 3: Reviews Complete All reviewers have approved the pull request and removed 1: Dev Review Requires review by a core commiter labels Jan 22, 2026
@cwarnermm cwarnermm merged commit a6ad0f2 into master Jan 22, 2026
5 checks passed
@cwarnermm cwarnermm deleted the claude/issue-8631-20260115-2204 branch January 22, 2026 14:02
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

3: Reviews Complete All reviewers have approved the pull request Guidance

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants