MM Blocks Documentation by larkox · Pull Request #9013 · mattermost/docs

larkox · 2026-06-06T12:25:50Z

github-actions · 2026-06-06T12:29:06Z

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

coderabbitai · 2026-06-06T12:42:00Z

Note

Reviews paused

It looks like this branch is under active development. To avoid overwhelming you with review comments due to an influx of new commits, CodeRabbit has automatically paused this review. You can configure this behavior by changing the reviews.auto_review.auto_pause_after_reviewed_commits setting.

Use the following commands to manage reviews:

@coderabbitai resume to resume automatic reviews.
@coderabbitai review to trigger a single review.

Use the checkboxes below for quick actions:

▶️ Resume reviews
🔍 Trigger review

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 9fc6b7e6-ca62-4431-9489-1b6d330629e1

📥 Commits

Reviewing files that changed from the base of the PR and between 0d690d9 and 06075f3.

📒 Files selected for processing (1)

source/integrations-guide/slash-commands.rst

🚧 Files skipped from review as they are similar to previous changes (1)

source/integrations-guide/slash-commands.rst

📝 Walkthrough

Walkthrough

Adds comprehensive MM Blocks documentation: a core reference page, integration-guide updates recommending MM Blocks and clarifying webhook/command parameters, end-user guidance on interacting with MM Blocks, and a troubleshooting page plus help-index and mobile troubleshooting pointers.

Changes

MM Blocks documentation suite

Layer / File(s)	Summary
MM Blocks core reference documentation `source/integrations-guide/mm-blocks.rst`	Comprehensive new reference defining MM Blocks structure, post properties (`props.mm_blocks`, `props.mm_blocks_actions`), supported block types, interactive action routing and API endpoints, examples, legacy payload handling, migration checklist, and end-user behaviour.
Integration developer guidance `source/integrations-guide/incoming-webhooks.rst`, `source/integrations-guide/outgoing-webhooks.rst`, `source/integrations-guide/faq.rst`, `source/integrations-guide/slash-commands.rst`, `source/integrations-guide/integrations-guide-index.rst`, `source/integrations-guide/webhook-integrations.rst`	Updated parameter tables to clarify when `text`, `attachments`, and `props.mm_blocks` are required; incoming/outgoing webhook guidance now recommends `props.mm_blocks`; FAQ adds “What are MM Blocks?”; slash-command example and integration index reference MM Blocks.
End-user interaction and feature availability `source/end-user-guide/collaborate/extend-mattermost-with-integrations.rst`, `source/end-user-guide/messaging-collaboration.rst`, `source/end-user-guide/access/client-availability.rst`	Adds "Interact with integration messages" guidance describing how MM Blocks render and how to use buttons, menus, collapsible and scrollable content; updates client availability table to mark MM Blocks support as conditional with a feature-flag footnote.
Troubleshooting guides and help resources `source/get-help/mm-blocks-troubleshooting.rst`, `source/get-help/get-help-index.rst`, `source/deployment-guide/mobile/mobile-troubleshooting.rst`	New troubleshooting page covers missing MM Blocks content, unresponsive buttons/menus, mobile scrollable/expand issues, collapsible/image problems, legacy attachment translation, and escalation links; help index and mobile troubleshooting now reference MM Blocks issues.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~8 minutes

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title 'MM Blocks Documentation' accurately describes the main change: comprehensive documentation for the MM Blocks feature across multiple documentation files and sections.
Description check	✅ Passed	The description is directly related to the changeset, providing context about the MM Blocks feature documentation by referencing technical specs, related PRs, and the associated ticket.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

Create PR with unit tests
Commit unit tests in branch interactiveMessages

Warning

Review ran into problems

🔥 Problems

Stopped waiting for pipeline failures after 30000ms. One of your pipelines takes longer than our 30000ms fetch window to run, so review may not consider pipeline-failure results for inline comments if any failures occurred after the fetch window. Increase the timeout if you want to wait longer or run a @coderabbit review after the pipeline has finished.

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

coderabbitai

Actionable comments posted: 2

🤖 Prompt for all review comments with AI agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@source/end-user-guide/access/client-availability.rst`:
- Around line 150-151: The MM Blocks support row currently appears
unconditional; update the table entry for "MM Blocks" (the row shown in the
diff) to indicate that support is conditional on the feature flag by adding
wording like "Conditional (requires MmBlocksEnabled)" or equivalent, and/or add
a footnote referencing the MmBlocksEnabled feature flag so admins know the
feature can be disabled; ensure the table cell replaces the plain checkmark with
this conditional text and add a short footnote explaining MmBlocksEnabled.

In `@source/get-help/mm-blocks-troubleshooting.rst`:
- Line 30: Change the vague "Verify network connectivity." sentence so it
explicitly states that Mattermost server nodes must be able to make outbound
HTTPS (TCP 443) connections to the integration action endpoint(s) configured by
the post author and that this outbound access is required (not inbound); update
the sentence matching "Verify network connectivity." to mention direction
(outbound), protocol (HTTPS/TCP 443), source (Mattermost server nodes),
destination (integration action endpoint URL), and that this access is required
and should be limited to those endpoints only.

🪄 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: e83f574b-6e12-479c-a7a5-372b3764b04d

📥 Commits

Reviewing files that changed from the base of the PR and between 60081c0 and ed6cdfb.

📒 Files selected for processing (13)

source/deployment-guide/mobile/mobile-troubleshooting.rst
source/end-user-guide/access/client-availability.rst
source/end-user-guide/collaborate/extend-mattermost-with-integrations.rst
source/end-user-guide/messaging-collaboration.rst
source/get-help/get-help-index.rst
source/get-help/mm-blocks-troubleshooting.rst
source/integrations-guide/faq.rst
source/integrations-guide/incoming-webhooks.rst
source/integrations-guide/integrations-guide-index.rst
source/integrations-guide/mm-blocks.rst
source/integrations-guide/outgoing-webhooks.rst
source/integrations-guide/slash-commands.rst
source/integrations-guide/webhook-integrations.rst

Copilot

Pull request overview

Adds end-to-end documentation coverage for the new MM Blocks interactive post format, and updates existing webhook/slash command docs plus end-user/help content to point readers to MM Blocks as the preferred approach over legacy message attachments.

Changes:

Adds a new developer reference page for MM Blocks payload structure, supported block types, actions, APIs, and migration from attachments.
Updates incoming/outgoing webhook and slash command docs to recommend MM Blocks and clarify payload requirements.
Adds end-user guidance and troubleshooting content (including mobile) for interacting with rich integration messages.

Reviewed changes

Copilot reviewed 13 out of 13 changed files in this pull request and generated 11 comments.

Show a summary per file

File	Description
source/integrations-guide/webhook-integrations.rst	Adds MM Blocks to the Webhooks section nav and positions it as the recommended interactive format.
source/integrations-guide/slash-commands.rst	Updates a slash command use case to reference MM Blocks for interactive results.
source/integrations-guide/outgoing-webhooks.rst	Documents MM Blocks support in outgoing webhook responses and updates parameter guidance.
source/integrations-guide/mm-blocks.rst	New dedicated reference page describing MM Blocks format, actions, API endpoint, and migration guidance.
source/integrations-guide/integrations-guide-index.rst	Highlights MM Blocks as the preferred interactive format when discussing Slack compatibility.
source/integrations-guide/incoming-webhooks.rst	Updates incoming webhook parameters and “Do More” section to recommend MM Blocks.
source/integrations-guide/faq.rst	Adds a new FAQ entry explaining what MM Blocks are.
source/get-help/mm-blocks-troubleshooting.rst	New troubleshooting page for MM Blocks rendering/action issues (with mobile emphasis).
source/get-help/get-help-index.rst	Adds the MM Blocks troubleshooting page to the Help section and links it in the Help Center list.
source/end-user-guide/messaging-collaboration.rst	Updates the end-user navigation blurb to mention interacting with rich integration messages.
source/end-user-guide/collaborate/extend-mattermost-with-integrations.rst	Adds end-user instructions for interacting with MM Blocks (buttons, menus, collapsible/scrollable content).
source/end-user-guide/access/client-availability.rst	Adds MM Blocks to the client availability matrix under Integrations.
source/deployment-guide/mobile/mobile-troubleshooting.rst	Adds a mobile troubleshooting pointer for MM Blocks integration posts.

github-actions · 2026-06-06T13:19:49Z

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

Copilot

Pull request overview

Copilot reviewed 13 out of 13 changed files in this pull request and generated 5 comments.

github-actions · 2026-06-08T09:47:28Z

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

github-actions · 2026-06-08T09:47:42Z

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

Copilot

Pull request overview

Copilot reviewed 13 out of 13 changed files in this pull request and generated 1 comment.

github-actions · 2026-06-08T10:48:49Z

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

Copilot

Pull request overview

Copilot reviewed 13 out of 13 changed files in this pull request and generated 1 comment.

github-actions · 2026-06-08T11:18:15Z

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

Initial documentation draft

ed6cdfb

larkox marked this pull request as ready for review June 6, 2026 12:37

Copilot AI review requested due to automatic review settings June 6, 2026 12:37

Copilot started reviewing on behalf of larkox June 6, 2026 12:38 View session

coderabbitai Bot requested changes Jun 6, 2026

View reviewed changes

Comment thread source/end-user-guide/access/client-availability.rst Outdated

Comment thread source/get-help/mm-blocks-troubleshooting.rst Outdated

Copilot AI reviewed Jun 6, 2026

View reviewed changes

Address review comments

0dc201a

larkox requested a review from Copilot June 6, 2026 13:16

Copilot started reviewing on behalf of larkox June 6, 2026 13:16 View session

larkox mentioned this pull request Jun 6, 2026

Initial draft for MM Blocks mattermost/mattermost-developer-documentation#1508

Open

coderabbitai Bot approved these changes Jun 6, 2026

View reviewed changes

Copilot AI reviewed Jun 6, 2026

View reviewed changes

larkox added 2 commits June 8, 2026 11:43

Address copilot comments

e125609

Merge branch 'master' into interactiveMessages

5154279

larkox requested a review from Copilot June 8, 2026 09:44

Copilot started reviewing on behalf of larkox June 8, 2026 09:44 View session

Copilot AI reviewed Jun 8, 2026

View reviewed changes

Comment thread source/deployment-guide/mobile/mobile-troubleshooting.rst Outdated

Address copilot comment

0d690d9

larkox requested a review from Copilot June 8, 2026 10:53

Copilot started reviewing on behalf of larkox June 8, 2026 10:53 View session

Copilot AI reviewed Jun 8, 2026

View reviewed changes

Comment thread source/integrations-guide/slash-commands.rst Outdated

Address comments

06075f3

larkox requested a review from svelle June 8, 2026 13:24

larkox requested a review from hanzei June 8, 2026 13:24

larkox added the 1: Dev Review Requires review by a core commiter label Jun 8, 2026

Conversation

larkox commented Jun 6, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Related PRs

Ticket Link

Uh oh!

github-actions Bot commented Jun 6, 2026

Uh oh!

coderabbitai Bot commented Jun 6, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Reviews paused

Walkthrough

Changes

Estimated code review effort

Review ran into problems

Uh oh!

coderabbitai Bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

github-actions Bot commented Jun 6, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

github-actions Bot commented Jun 8, 2026

Uh oh!

github-actions Bot commented Jun 8, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

github-actions Bot commented Jun 8, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

github-actions Bot commented Jun 8, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

larkox commented Jun 6, 2026 •

edited

Loading

coderabbitai Bot commented Jun 6, 2026 •

edited

Loading