Skip to main content
Mentions are attached to content creation or edit calls. They use two pieces of data: mentionees tells Social+ which users or channel are mentioned, and metadata stores the text ranges your UI can use to render the highlighted mention text.
User mentions are available on posts, comments, and messages. Channel mentions are message-only.

Platform Surface

Parameters

Create Content With A User Mention

The examples below create a community text post that mentions one user. Use the same mentionee and metadata pattern when creating comments or messages with the SDK-specific creation API.

Rendering Mentions

Use the content text and metadata.mentioned entries together when rendering. The mentionees payload identifies mentioned users or channel targets, while metadata identifies where the mention appears in the text.

Notes

  • Keep metadata and mentionees in sync. A highlighted @alex without a matching mentionee payload is only display metadata.
  • Use the user IDs returned by your mention picker. Display names can change, but user IDs are the stable mention target.
  • For messages, channel mentions use a channel mentionee entry. Posts and comments use user mentionees.
  • Existing content models expose mention information after creation; use the model returned by the SDK or a fresh query when your UI needs server-confirmed state.

Text Posts

Create text posts that can carry mention metadata

Text Comment

Add user mentions to comments and replies

Send A Message

Use user and channel mentions in chat messages