Skip to main content
Mentions in AppFlowy let you bring someone’s attention to specific content, ask questions, or assign tasks. Tagged users receive email notifications so they never miss important updates.

​
Overview

With mentions, you can:
  • Notify teammates about specific content or changes
  • Assign tasks by mentioning someone in context
  • Ask questions directly in documents
  • Link to pages using page mentions
  • Set reminders with date mentions
  • Receive email notifications when mentioned
Mention features were introduced in version 0.9.7 for both desktop and mobile platforms.

​
Types of Mentions

AppFlowy supports several types of mentions to help you collaborate effectively:

Person Mentions

Tag teammates to notify them about content or assign tasks.

Page Mentions

Link to other pages in your workspace for easy reference.

Date Mentions

Add dates and reminders directly in your content.

​
Mentioning People

​
Creating a Person Mention

There are two ways to mention someone:
1

Use @ Symbol

Type @ anywhere in your document. A menu appears showing workspace members.
2

Search and Select

Start typing the person’s name to filter the list, then click to select them.
3

Continue Writing

The mention appears as a highlighted tag. Continue writing your message or context.
Alternative Method: Use the slash menu:
  1. Type / to open the command menu
  2. Select “Mention a person” or type ”@”
  3. Choose the person from the list
You can mention any member of your workspace. To mention external collaborators, first invite them as Guest Editors.

​
Email Notifications

When you mention someone:
  • They receive an email notification with:
    • Who mentioned them
    • The page where they were mentioned
    • Context around the mention
    • A direct link to the mention location
  • Notifications are sent immediately when the mention is created
  • Recipients can click the link to jump directly to the mentioned content
Email notifications are sent to the email address associated with the user’s AppFlowy account.

​
Using Mentions for Task Assignment

Mentions are perfect for assigning work to teammates:

​
Assignment Pattern

Create clear task assignments: 
@John Smith - Please review the Q4 budget proposal by Friday

@Sarah Lee - Can you update the client presentation with the latest metrics?

@Team Lead - This section needs your approval before we publish

​
Best Practices for Assignments

1

Be Specific

Clearly state what needs to be done. Include context and deadlines.
2

Mention One Person

Assign tasks to individuals, not groups, for accountability.
3

Add Due Dates

Combine person mentions with date mentions for complete task information.
4

Follow Up

Check in if the mentioned person hasn’t responded or completed the task.
Mentions are notifications, not a formal task management system. For complex project tracking, consider using AppFlowy’s database features with assigned person fields.

​
Page Mentions

Link to other pages in your workspace using page mentions:

​
Creating Page Mentions

1

Type $ Symbol

Use $ to trigger the page mention menu.
2

Search for Pages

Start typing the page name to filter available pages.
3

Select Page

Click the page you want to reference. A link is created.

​
Page Mention Use Cases

Reference Documents

Link to related pages, documentation, or background information.

Create Navigation

Build a table of contents or index page with mentions to other pages.

Show Dependencies

Indicate which pages are related or depend on each other.

Quick Access

Create shortcuts to frequently referenced pages.

​
Handling Deleted Pages

If a mentioned page is deleted or you lose access:
  • The mention shows as “Deleted Page” or “No Access”
  • A trash icon appears for deleted pages
  • You can remove the mention or replace it with a valid page
Page mentions automatically update if the referenced page is renamed.

​
Date Mentions

Add dates and create reminders with date mentions:

​
Creating Date Mentions

  1. Type $ or / to open the command menu
  2. Select “Date” or start typing a date
  3. Use the date picker to select a specific date
  4. Optionally add a time and reminder

​
Date Mention Features

  • Date picker: Visual calendar for selecting dates
  • Natural language: Type “tomorrow”, “next Friday”, etc.
  • Time support: Add specific times to your dates
  • Reminders: Set notifications for important dates
Date mentions support various formats and can be configured to match your preferences in Settings.

​
Mention Notifications

​
Desktop Notifications

On desktop, you’ll see mentions in the notification center:
  1. Click the notification bell icon
  2. View all your mentions
  3. Click any mention to jump to its location
  4. Mark mentions as read to clear them

​
Mobile Notifications

On mobile devices:
  • Receive push notifications for new mentions
  • View mentions in the mobile notification center
  • Tap to navigate directly to the mentioned content

​
Managing Notifications

Control mention notifications in Settings:
  1. Go to Settings → Notifications
  2. Toggle mention notifications on or off
  3. Configure email notification preferences
  4. Set notification frequency (immediate, digest, etc.)
Notification settings were improved in version 0.9.0 with a revamped notification center.

​
Mention Workflows

​
Review and Feedback

Use mentions for document reviews: 
@Reviewer - Does this section accurately reflect our new pricing model?

@Editor - Please check grammar in the introduction

@Subject Matter Expert - Can you verify these technical details?

​
Collaborative Writing

Coordinate content creation: 
@Writer - Please draft the executive summary

@Designer - We need a diagram for this section

@Data Analyst - Add the latest metrics here

​
Meeting Notes

Capture action items: 
Action Items:
- @John - Book the conference room for next week
- @Sarah - Send the presentation to stakeholders by Tuesday
- @Mike - Follow up with the client about their feedback

​
Best Practices

Provide Context

Always explain why you’re mentioning someone. Don’t just tag without explanation.

Avoid Mention Spam

Don’t over-mention people. Use mentions for important items that truly need attention.

Respond to Mentions

When mentioned, respond or complete the task promptly. This builds trust and accountability.

Use Check Notifications

Regularly check your notification center to ensure you don’t miss any mentions.

​
Keyboard Shortcuts

Work faster with mention shortcuts:
ActionShortcut
Insert person mentionType @
Insert page mentionType $
Insert date mentionType $ then “date”
Open slash menuType /
Navigate mention menuArrow keys
Select from menuEnter

​
Platform Support

​
Desktop (v0.9.7+)

  • Full mention support for persons, pages, and dates
  • Email notifications
  • In-app notification center
  • Rich mention previews

​
Mobile (v0.9.7+)

  • Create and view all mention types
  • Push notifications for mentions
  • Mobile notification center
  • Tap mentions to navigate

​
Troubleshooting

​
Person Not Showing in Mention Menu

  • Verify they’re a member of your workspace
  • Check if they’ve accepted their invitation
  • Ensure you have an internet connection
  • Refresh the page to sync the latest member list

​
Mention Notifications Not Received

  • Check notification settings in Settings → Notifications
  • Verify email address is correct in user profile
  • Check spam/junk folder for mention emails
  • Ensure the workspace is syncing properly

​
Can’t Mention on a Page

  • Verify you have Can Edit permissions on the page
  • Check that you’re not in a read-only view
  • Ensure you’re logged in to your workspace account

​
Next Steps

Real-Time Editing

Collaborate simultaneously with teammates

Sharing Pages

Share pages with team members and set permissions

Guest Editors

Invite external collaborators to your pages

Build docs developers (and LLMs) love

Get started for freeTalk to us