Document Comments & Teams Sync
Every Document page has its own comment thread, and it works the same way task comments do: discussion stays attached to the page, mentioned people get a real Teams notification, and replies in the Teams thread come back into the page.
Commenting on a page
- Open a Document and use the Comments section at the bottom of the page.
- Write your comment and, if needed, @mention project members from the mention picker (member pills) so they're notified.
- Comments show the author, avatar, and time, and the page keeps a running comment count.
- You can delete your own comment; an Owner or Admin can remove any comment.
How comments flow to Teams — and back
- When a Document is created or edited, an Adaptive Card is posted to the project's linked Teams channel, establishing that page's thread.
- Comments and mentions surface in that Teams thread, so the team sees document activity where they already work (see Adaptive Cards and Task Previews for how cards behave).
- Replies in the Teams thread sync back to the page as comments — a reply made in Teams appears in the Document's comment list (marked as coming from Teams), so the conversation stays complete on both sides. This is the same two-way model as task comments (see Commenting with Mentions in Channels).
Best practices
- Keep discussion about a page on the page — in its comments or by replying in its Teams thread — rather than in a separate channel message, so it stays with the document.
- Mention deliberately: each @mention is a real Teams notification for that person.
- Use comments for questions and decisions about the content; fold the resolved outcome back into the page itself (with an edit note) so the page stays the source of truth.
Because Document conversations are tied to the page and mirrored in Teams both ways, knowledge and the discussion around it never drift apart.