Mention users and posts

How to get there: Open any rich text editor in ProductLift (post description, public comment, internal comment). Type @ to mention a user, or # to mention another post.

Mentions let you pull a teammate into a thread or reference another post inline. They work in post descriptions, public comments, and internal comments.

The two syntaxes

ProductLift stores mentions as compact tokens in the source text and expands them at render time.

  • User mention: <@user-key> where user-key is the user's UUID key. Renders as a clickable link to the user's profile, like @Jane Doe.
  • Post mention: #postkey (post not found) where postkey is the target post's portal_post_key (the short ID at the end of the post URL). Renders as a small card showing the post title and a click-through.

You rarely have to type these tokens by hand. The editor autocomplete inserts them for you.

Using the editor autocomplete

In the rich text editor:

  1. Type @ to start a user mention, or # to start a post mention.
  2. Keep typing to filter the dropdown by name or post title.
  3. Pick an entry from the list. The editor inserts the right <@...> or <#...> token.

A second flow is available from the Add mention button in the toolbar. It opens a search dialog with separate Users and Posts tabs, useful when you do not remember the exact name.

What gets notified

When a user is mentioned in a comment, ProductLift sends them an email notification, with three guardrails:

  • The user must have mention notifications enabled in their profile. If they globally unsubscribed from mentions, no email is sent.
  • The user must not have unsubscribed from mentions on that specific post. Each mention email includes a one-click unsubscribe for that single post.
  • Post mentions (#postkey (post not found)) do not trigger notifications. They are a navigation aid, not a ping.

Mentions inside post descriptions render as links and cards but do not currently fire a separate notification.

Where mentions work

  • Post descriptions
  • Public comments (including replies)
  • Internal comments

Mentions render the same way in each location. Post mention cards always link to the target post, even when the reader cannot vote or comment on it.