About Us Developer Portal Archives

Roles & Permissions

AmityClient class provides a method hasPermission which allows you to check if the current logged in user has permission to do stuff in given channel.

We determine a user's moderation capabilities based on their current role. Amity SDK has the following default roles:

  1. Member - has no moderation privileges

  2. Community/Channel Moderator - can assert general moderation privileges on other users

  3. Super Moderator - can assert general moderation privileges and be exempt from moderation from other users

  4. Global Admin (Admin Only) - can assign the roles of others, assert all moderation privileges and be exempt from moderation

A user's role can be changed via Console. Refer to Moderation, Roles & Privileges for the instructions on how to change a user's role.

The Global Admin role cannot be assigned to a user.

Below are tables for each category that show the default roles and permissions. You can create new roles and assign a specific set of permissions for each role in the ASC Console. Refer to Moderation, Roles & Privileges.

User

PermissionGlobal AdminSuper ModeratorCommunity ModeratorChannel Moderator

ASC 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 repitition check

✅

✅

❌

❌

*UserV3

Channel

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

✅

✅

❌

❌

*ChannelV3

Community

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

✅

✅

✅

❌

*CommunityV3

There is no limit to the number of moderators in a community. If there are 100 members in the community, all 100 members can be promoted to moderator. Promoting a user to a community-level moderator can be done using the Update Role API or through the SDK.

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

✅

✅

✅

✅

Permissions

Each role can be assigned with many permissions. Below is a list of all the possible permissions that can be assigned to a user.

Source

Permission

Description

Channel

MUTE_CHANNEL

Can mute/unmute channel

CLOSE_CHANNEL

Can close channel

EDIT_CHANNEL

Can edit channel

EDIT_CHANNEL_RATELIMIT

Can set rate limit of channel

EDIT_MESSAGE

Can edit all messages

DELETE_MESSAGE

Can delete all messages

BAN_CHANNEL_USER

Can ban/unban user from channel

MUTE_CHANNEL_USER

Can mute/unmute user in channel

ADD_CHANNEL_USER

Can add users to channel

REMOVE_CHANNEL_USER

Can add remove user from channel

EDIT_CHANNEL_USER

Can edit users in channel

User

BAN_USER

Can global ban/unban user

EDIT_USER

Can edit users

ASSIGN_USER_ROLE

Can assign role to users

User feed

EDIT_USER_FEED_POST

Can edit all posts on user feed

DELETE_USER_FEED_POST

Can delete all posts in user feed

EDIT_USER_FEED_COMMENT

Can edit all comments on user feed

DELETE_USER_FEED_COMMENT

Can delete all comments in user feed

Community

ADD_COMMUNITY_USER

Can add users to community

REMOVE_COMMUNITY_USER

Can remove users from community

EDIT_COMMUNITY_USER

Can edit users in community

BAN_COMMUNITY_USER

Can ban users in community

MUTE_COMMUNITY_USER

Can mute users in community

EDIT_COMMUNITY

Can edit community

DELETE_COMMUNITY

Can delete community

EDIT_COMMUNITY_POST

Can edit all posts in community feed

DELETE_COMMUNITY_POST

Can delete all posts in community feed

EDIT_COMMUNITY_COMMENT

Can edit all comments in community feed

DELETE_COMMUNITY_COMMENT

Can delete all comments in community feed

REVIEW_COMMUNITY_POST

Can review community post

MANAGE_COMMUNITY_STORY

Can create and delete community story

Community Category

CREATE_COMMUNITY_CATEGORY

Can create new community categories

EDIT_COMMUNITY_CATEGORY

Can edit community categories

DELETE_COMMUNITY_CATEGORY

Can delete community categories

Network

CREATE_ROLE

Can create new roles

EDIT_ROLE

Can edit roles

DELETE_ROLE

Can delete roles

Notification

MANAGE_NOTIFICATION_NETWORK_SETTING

Can manage notification settings

Last updated