Skip to main content
This reference guide provides comprehensive information about the notification event types supported by the social.plus SDK. Each event type has specific triggers, recipients, and message templates that define how notifications are generated and delivered to users.
This documentation reflects the exact supported notification events and message templates as implemented in the social.plus SDK. Only the events listed below are currently supported.

Event Types

Complete catalog of supported notification event types

Message Templates

Predefined message formats for each event type

Triggers & Recipients

When notifications are triggered and who receives them

Grouping Logic

How similar notifications are grouped together

​
Supported Event Types

The notification tray supports the following event types with specific triggers and message templates:
  • Content Events
  • Engagement Events
  • Grouping Logic
Content Creation & Activity
  • Post creation (Text, Image, Video)
  • Poll creation
  • Comments on posts
  • Replies to comments

​
Content Creation Events

​
Post Events

Event Type: post (Text, Image, Video)Trigger: When a user creates a post in a communityRecipients: All community membersConditions:
  • Given Bob & Alice are members of the same community
  • When Bob creates a post in that community
  • Then Alice should see a notification record in the notification tray about this action
Message Templates:Single Event:
Bob posted in ``communityDisplayName``
Grouped Events (2 actors):
``displayName_1`` and ``displayName_2`` posted in ``communityDisplayName``
Grouped Events (3+ actors):
``displayName_1`` and ``number`` others posted in ``communityDisplayName``
Grouping Logic:
  • Given Bob, Alice, Charlie, and Daniel are members of the same community
  • When more than one member creates a post in the same community within the same day
  • Then the notifications are grouped together for better user experience
Event Type: pollTrigger: When a user starts a poll in a communityRecipients: All community membersConditions:
  • Given Bob & Alice are members of the same community
  • When Bob starts a poll in that community
  • Then Alice should see a notification in the notification tray about this action
Message Template:
Bob started a poll in ``communityDisplayName``

​
Comment Events

Event Type: commentTrigger: When a user comments on a postRecipients: Post authorConditions:
  • When Bob comments on Alice’s post
  • Then Alice should see a notification in the notification tray
Message Templates:Community Post:
Bob commented on your post in ``communityDisplayName``
User Feed - Own Feed:
Bob commented on your post on your feed
User Feed - Another User’s Feed:
Bob commented on your post on ``targetUserDisplayName`` feed
Event Type: replyTrigger: When a user replies to a commentRecipients: Original comment authorConditions:
  • When Bob replies to Alice’s comment
  • Then Alice should see a notification in the notification tray
Message Templates:Community Comment:
Bob replied to your comment in ``communityDisplayName``
User Feed - Own Feed:
Bob replied to your comment on your feed
User Feed - Another User’s Feed:
Bob replied to your comment on ``targetUserDisplayName`` feed

​
Engagement Events

​
Reaction Events

Event Type: reactionTrigger: When a user reacts to a post, poll, comment, or replyRecipients: Content authorConditions:
  • When Bob reacts to Alice’s content
  • Then Alice should see a notification in the notification tray
Message Templates:Post Reaction - Community:
Bob reacted to your post in ``communityDisplayName``
Post Reaction - User Feed (Own):
Bob reacted to your post on your feed
Post Reaction - User Feed (Another User’s):
Bob reacted to your post on ``targetUserDisplayName`` feed
Poll Reaction - Community:
Bob reacted to your poll in ``communityDisplayName``
Comment Reaction - Community:
Bob reacted to your comment in ``communityDisplayName``
Comment Reaction - User Feed (Own):
Bob reacted to your comment on your feed
Comment Reaction - User Feed (Another User’s):
Bob reacted to your comment on ``targetUserDisplayName`` feed
Reply Reaction - Community:
Bob reacted to your reply in ``communityDisplayName``
Reply Reaction - User Feed (Own):
Bob reacted to your reply on your feed
Reply Reaction - User Feed (Another User’s):
Bob reacted to your reply on ``targetUserDisplayName`` feed

​
Mention Events

Event Type: mentionTrigger: When a user mentions another user in a post, poll, comment, or replyRecipients: Mentioned userConditions:
  • When Bob mentions Alice in content
  • Then Alice should see a notification in the notification tray
Message Templates:Post Mention - Community:
Bob mentioned you in a post in ``communityDisplayName``
Post Mention - User Feed (Own):
Bob mentioned you in a post on your feed
Post Mention - User Feed (Another User’s):
Bob mentioned you in a post on ``targetUserDisplayName`` feed
Poll Mention - Community:
Bob mentioned you in a poll in ``communityDisplayName``
Comment Mention - Community:
Bob mentioned you in a comment in ``communityDisplayName``
Comment Mention - User Feed (Own):
Bob mentioned you in a comment on your feed
Comment Mention - User Feed (Another User’s):
Bob mentioned you in a comment on ``targetUserDisplayName`` feed
Reply Mention - Community:
Bob mentioned you in a reply in ``communityDisplayName``
Reply Mention - User Feed (Own):
Bob mentioned you in a reply on your feed
Reply Mention - User Feed (Another User’s):
Bob mentioned you in a reply on ``targetUserDisplayName`` feed

​
Follow Events

Event Type: followTrigger: When a user follows another userRecipients: User being followedConditions:
  • When Bob follows Alice
  • Network settings have follow requests disabled (socialSetting.isFollowWithRequestEnabled = false)
  • Then Alice should see a notification in the notification tray
Message Template:
Bob started following you
Important Notes:
  • This notification is only triggered when follow requests are disabled in the network settings
  • If follow requests are enabled, this notification will not be generated
  • No grouping is applied to follow events - each follow action creates an individual notification

​
Grouping Logic

​
Event Aggregation

Notifications are grouped based on specific criteria to provide a better user experience:
Rule: Post events in the same community within the same day are grouped together.Supported For: Only post eventsExamples:
  • Multiple users posting in the same community on the same day
Message Format:
  • 2 actors: displayName_1 and displayName_2 posted in communityDisplayName
  • 3+ actors: displayName_1 and number others posted in communityDisplayName
Rule: All other events remain as individual notifications.Supported For: poll, comment, reply, reaction, mention, followExamples:
  • A single user mentioning you in a post
  • A single reaction to your content
  • A single comment on your post
  • A single user following you
Message Format:
  • Standard individual event message templates as specified above

​
Template Variables

​
Common Variables

The following variables are available in message templates:
  • displayName - Actor’s display name (for single events)
  • displayName_1 - First actor’s display name (grouped events)
  • displayName_2 - Second actor’s display name (grouped events)
  • targetUserDisplayName - Target user’s display name (for user feed posts)
  • communityDisplayName - Community display name
  • number - Number of additional actors (for 3+ grouped events)

​
Implementation Notes

Important: This documentation reflects the exact supported notification events. Only the events, actions, and message templates listed above are currently implemented in the social.plus SDK.

Event Handling

Process notification events in real-time to provide immediate feedback to users about relevant activities.

Message Customization

Use the template variables to create personalized and contextual notification messages.

Grouping Strategy

Only post events support grouping. All other events remain as individual notifications.

Testing

Test all event types and message templates to ensure proper formatting and user experience.