social.plus SDK provides a comprehensive role-based access control system that allows you to manage user permissions across your social features. This system enables you to create hierarchical moderation structures and fine-grained access control.

​
Overview

Permission-Based System: social.plus determines user capabilities based on their assigned roles. Each role carries specific permissions that control what users can do within your application.

​
Key Concepts

Roles

User Classifications
Predefined or custom user types with specific permission sets

Permissions

Granular Controls
Specific actions users can perform (edit, delete, ban, etc.)

Hierarchy

Structured Access
Roles have different levels of access and moderation privileges

​
Permission Checking

Use the hasPermission method to check if the current user can perform specific actions: 
// Check if user has permission to delete messages in a channel
if client.hasPermission(.deleteMessage, in: channelId) {
    // User can delete messages
    showDeleteOption()
} else {
    // User cannot delete messages
    hideDeleteOption()
}

​
Role Descriptions

Global Admin Role: This role cannot be assigned to regular users and is reserved for platform administrators only.

​
Permission Matrix

​
User Permissions

PermissionGlobal AdminSuper ModeratorCommunity ModeratorChannel Moderator
SP Console Access✅✅❌❌
Create, Edit, & Delete Roles✅✅✅✅
Ban & Edit User✅❌❌❌
Exempt from filters✅✅❌❌
Exempt from rate limits✅✅❌❌
Exempt from mute✅✅❌❌
Exempt from ban✅✅❌❌
Exempt from blacklist & whitelist✅✅❌❌
Exempt from repetition check✅✅❌❌

​
Channel Permissions

PermissionGlobal AdminSuper ModeratorCommunity ModeratorChannel Moderator
Edit, Ban, Add, Remove, & Mute Channel User*✅✅❌✅
Edit & Mute Channel*✅✅❌✅
Edit & Delete Message*✅✅❌✅
Edit Channel Rate Limit*✅❌❌❌
Ban, Mute, Rate limit, & Manage Users✅✅❌✅
Mute Channels✅✅❌✅
Rate Limit Channels✅✅❌✅
Manage Messages✅✅❌✅
Global Access✅✅❌❌

​
Community Permissions

PermissionGlobal AdminSuper ModeratorCommunity ModeratorChannel Moderator
Create, delete, Edit Community Categories✅✅✅❌
Edit & Delete Communities*✅✅✅❌
Edit, Add, Ban, & Remove Community Users*✅✅✅❌
Edit, Delete, & Review Community Posts*✅✅✅❌
Edit & Delete Community Comments*✅✅✅❌
Manage Community✅✅✅❌
Manage Community Stories✅✅✅❌

​
User Feed, Posts, Comments, & Notifications

PermissionGlobal AdminSuper ModeratorCommunity ModeratorChannel Moderator
Edit & Delete User Feed Post✅✅✅❌
Edit & Delete User Feed Comment✅✅✅❌
Manage Posts & Comments✅✅✅❌
Manage Network Settings✅✅✅✅
*CommunityV3 - Refers to the latest community management system version

​
Detailed Permission List

​
Channel Permissions

PermissionDescription
MUTE_CHANNELCan mute/unmute channel
CLOSE_CHANNELCan close channel
EDIT_CHANNELCan edit channel
EDIT_CHANNEL_RATELIMITCan set rate limit of channel
EDIT_MESSAGECan edit all messages
DELETE_MESSAGECan delete all messages
BAN_CHANNEL_USERCan ban/unban user from channel
MUTE_CHANNEL_USERCan mute/unmute user in channel
ADD_CHANNEL_USERCan add users to channel
REMOVE_CHANNEL_USERCan remove user from channel
EDIT_CHANNEL_USERCan edit users in channel

​
User Permissions

PermissionDescription
BAN_USERCan global ban/unban user
EDIT_USERCan edit users
ASSIGN_USER_ROLECan assign role to users

​
User Feed Permissions

PermissionDescription
EDIT_USER_FEED_POSTCan edit all posts on user feed
DELETE_USER_FEED_POSTCan delete all posts in user feed
EDIT_USER_FEED_COMMENTCan edit all comments on user feed
DELETE_USER_FEED_COMMENTCan delete all comments in user feed

​
Community Permissions

PermissionDescription
ADD_COMMUNITY_USERCan add users to community
REMOVE_COMMUNITY_USERCan remove users from community
EDIT_COMMUNITY_USERCan edit users in community
BAN_COMMUNITY_USERCan ban users in community
MUTE_COMMUNITY_USERCan mute users in community
EDIT_COMMUNITYCan edit community
DELETE_COMMUNITYCan delete community
EDIT_COMMUNITY_POSTCan edit all posts in community feed
DELETE_COMMUNITY_POSTCan delete all posts in community feed
EDIT_COMMUNITY_COMMENTCan edit all comments in community feed
DELETE_COMMUNITY_COMMENTCan delete all comments in community feed
REVIEW_COMMUNITY_POSTCan review community post
MANAGE_COMMUNITY_STORYCan create and delete community story

​
Community Category Permissions

PermissionDescription
CREATE_COMMUNITY_CATEGORYCan create new community categories
EDIT_COMMUNITY_CATEGORYCan edit community categories
DELETE_COMMUNITY_CATEGORYCan delete community categories

​
Network Permissions

PermissionDescription
CREATE_ROLECan create new roles
EDIT_ROLECan edit roles
DELETE_ROLECan delete roles

​
Notification Permissions

PermissionDescription
MANAGE_NOTIFICATION_NETWORK_SETTINGCan manage notification settings

​
Role Assignment

​
Through Admin Console

  1. Access social.plus Console with admin privileges
  2. Navigate to User Management section
  3. Select the user you want to modify
  4. Assign or modify roles from available options
  5. Save changes to apply new permissions
📖 Detailed Instructions: Refer to Moderation, Roles & Privileges in the Console documentation.

​
Through Update User API

Use the Update Role API to modify user roles programmatically (refer to API Reference introduction until specific endpoint docs are published).

​
Custom Roles

Unlimited Flexibility: You can create custom roles and assign specific permissions in the social.plus Console to match your application’s unique requirements.

​
Creating Custom Roles

  1. Access Admin Console → Roles & Permissions
  2. Create New Role with a descriptive name
  3. Select Permissions from the available list
  4. Save and Assign to users as needed

​
Best Practices for Custom Roles

Role Design

Do:
  • Create roles based on user responsibilities
  • Use descriptive role names
  • Plan for role hierarchy
  • Consider future permissions
Don’t:
  • Create too many similar roles
  • Use confusing role names
  • Overlap permissions unnecessarily
  • Forget to document role purposes

Permission Assignment

Do:
  • Grant minimum necessary permissions
  • Group related permissions together
  • Test role functionality thoroughly
  • Document permission reasoning
Don’t:
  • Over-privilege roles
  • Create security gaps
  • Ignore permission dependencies
  • Rush role creation

​
Moderation Scaling

No Moderator Limits: There is no limit to the number of moderators in a community. If there are 100 members in a community, all 100 members can be promoted to moderator roles if needed.

​
Moderation Strategy

1

Start Small

Begin with a few trusted moderators and expand based on community growth
2

Delegate Responsibly

Assign community moderators for specific areas (channels, topics, regions)
3

Monitor Performance

Track moderation effectiveness and adjust roles as needed
4

Scale Up

Promote active, helpful community members to moderator roles

​
Next Steps

User Operations

Learn how to query, search, and manage users with repositories