Role Permissions
Fine-grained control over how your staff team interacts with Ostra.
① Understand the basics of Ostra's permissions system
Many Ostra features may allow users to perform potentially sensitive actions, or access sensitive data. Because of
this, by default, Ostra will only allow members to interact with these features if they have the Manage Server
Discord permission. However, Ostra also offers a robust permissions system so you can grant your moderators the permissions
they need. There are 2 ways you can grant permissions to a role: either by
granting individual permissions to roles, which is recommended as it gives you the most
control over how permissions work in your server, or by creating Moderator Roles and
Manager Roles. Ostra breaks permissions down into 3 Permission Levels. A
Permission Level defines how sensitive a permission is to grant. Features with a lower Permission Level will
natually be available to more members in your server. Ostra's Permission Levels and how they function are as
follows:
Level
Description
Moderator
Requires a Moderator Role or a Manager Role to use.
Manager
Requires a Manager Role to use.
Admin
Requires the Manage Server Discord permission to use.
NOTE: Members with the Manage Server Discord permission always have permission
to use a feature unless explicitly stated otherwise.
Level | Description |
---|---|
Moderator | Requires a Moderator Role or a Manager Role to use. |
Manager | Requires a Manager Role to use. |
Admin | Requires the Manage Server Discord permission to use. |
② Grant permissions to a role
To grant permissions to a role, use the /settings permissions grant command. From there, select the
role you want to grant permissions to, and then select the permission you want to grant to it.
List of grantable permissions:
Permission
Description
Level
Warn Members
Warn members via the /warn command.
Moderator
Kick Members
Kick members via the /kick command.
Moderator
Mute Members
Mute members via the /mute command.
Moderator
Ban Members
Ban members via the /ban command.
Moderator
Inspect Punishments
View member punishment histories and inspect punishment details.
Moderator
Revert Punishments
Revert member punishments, includes the /unban and /unmute commands.
Moderator
Purge Messages
Bulk-delete messages from a text channel.
Moderator
Manage Role Menus
Create, edit, and delete Role Menus.
Manager
Manage Role Permissions
Grant, revoke, and view role permissions.
Admin
Permission | Description | Level |
---|---|---|
Warn Members | Warn members via the /warn command. | Moderator |
Kick Members | Kick members via the /kick command. | Moderator |
Mute Members | Mute members via the /mute command. | Moderator |
Ban Members | Ban members via the /ban command. | Moderator |
Inspect Punishments | View member punishment histories and inspect punishment details. | Moderator |
Revert Punishments | Revert member punishments, includes the /unban and /unmute commands. | Moderator |
Purge Messages | Bulk-delete messages from a text channel. | Moderator |
Manage Role Menus | Create, edit, and delete Role Menus. | Manager |
Manage Role Permissions | Grant, revoke, and view role permissions. | Admin |