Product Documentation ‐ Getting Started with Real‐Time Collaboration in Notion: Comments, Mentions & Reactions - Ewa-create/tech-docs GitHub Wiki
Read time: 3-4 mins
Disclaimer: This is sample product documentation and help content for a personal portfolio. Iyanuoluwa Fesobi is not affiliated with Notion in any way. This is for example purposes only.
Table of Contents
Understanding Real-Time Collaboration in Notion
In Notion, real-time collaboration means that changes made by any team member are visible to others immediately. When someone adds text, edits a page, or leaves a comment, other collaborators see the update without needing to refresh the page. This ensures that everyone is always working with the most current version of a page or workspace.
This guide explains how to use comments, mentions, and reactions in Notion to collaborate with others in real time. You’ll learn how to leave feedback, tag teammates, and keep discussions tied directly to the content you’re working on.
Using Comments
Comments allow collaborators to give feedback, ask questions, or provide context without directly editing content. Comments are attached to a specific block, page, or database entry, keeping discussions organized and relevant.
Adding Comments to Pages
-
Hover over the page you want to comment on.
-
Click on the 'add comment option'.
-
Type your message and press send/enter.
Figure 1. Page Comment

Adding Comments to Blocks
-
Click the ⋮⋮ icon that appears to the left of it and choose Comment from the menu that pops up.
-
Type your message in the comment field and press send/enter.
Figure 2. Block Comment

Adding Inline Comments
-
Highlight the text you want to comment on.
-
Choose comment from the pop-up menu.
-
Type and send your comment in the field.
Figure 3. Inline Comment

Replying to and Resolving Comments
To reply, click on the comment and type your response in the reply field.
Figure 4. Replying to a Comment

To mark a comment/discussion as resolved, hover over it and tick the ✔️ icon that appears. Resolved comments are archived but can be viewed in version history.
Figure 5. Resolving a Comment

See this guide for database commenting.
Using Mentions
Mentions in Notion allow you to notify collaborators and link to pages, people, or dates directly from a block or comment. They help keep your team informed and discussions contextual.
Mentioning People
-
In a block or comment, type @ followed by the collaborator’s name.
-
Select the person from the dropdown list.
The person will receive a notification and a link to the content where they were mentioned.
Figure 6. Mentioning a Person

Mentioning Pages
-
Type @ followed by the page name.
-
Select the page from the dropdown list.
A link to the page will be inserted in your block or comment, making navigation easy for collaborators.
Figure 7. Mentioning a Page

Mentioning Dates
- Type @ and select a date from the calendar dropdown.
This creates a date reference that can trigger reminders or scheduling within Notion.
Figure 8. Mentioning a Date

To learn how to mention someone in a database, see this guide
Reactions
Inline reactions
-
Select the text on the page that you want to react to.
-
Click on 🙂 in the menu that appears.
-
Pick an emoji of your choice.
Figure 9. Inline Reaction

Reacting to a Comment
-
Hover over a comment, or click it (mobile).
-
Click on 🙂 in the pop-up.
-
Pick an emoji of your choice to use as a reaction.
Figure 10. Comment Reaction

FAQs
-
Why can’t I see a comment or mention someone made?
They may not have access to the page or database. Refresh your page, and double-check that the comment was added to the correct block.
-
Why can’t a collaborator edit a page or view I shared?
Permissions may be set to view-only, or individual access overrides workspace defaults. Check the page’s Share settings and adjust permissions for each collaborator.
-
Why aren’t changes showing up in real time?
Notion updates live, but sync delays can occur due to connectivity issues. Try refreshing the page, and make sure you’re online.
-
How do I avoid accidentally missing updates?
Use mentions for relevant collaborators, regularly check the comments section, and turn on notifications for comments and mentions.
Contact Notion support for any advanced issues.
Where to Go Next in Notion
-
Try features such as database commenting and rich formatting.
-
Experiment with linked databases and filtered views to create tailored workflows.
-
Explore team templates and shared workspaces to streamline collaboration.