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.

② 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.

Failed to load
Failed to load

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

③ View the permissions a role has

After setting up the role's permissions, use the /settings permissions list command to verify that the role is set up correctly. From here, you can see all permissions granted to this role, as well as whether or not it is a Moderator Role or a Manager Role.

Failed to load
Failed to load

④ Revoke permissions from a role

Assigned a permission by accident? Use the /settings permissions revoke command to revoke permissions from a role. It works identicaly to how the /settings permissions grant command works. Prefer to start over and revoke all permissions from a role? Use the /settings permissions clear command. Keep in mind this will only revoke granted permissions, and will not remove the role as a Moderator or Manager role.