Skip to main content
Venon Security slash commands

How do you grant a temporary role on Discord with the /temporary-role slash command?

/temporary-role belongs to the moderation category and is part of the Temprole module. An administrator or a moderator reaches for it when the action has to be fast, fully traceable in the logs and in line with Discord's permissions.

Moderation

Category

Manage Roles

Permissions

5

Parameters

What it does

What is the /temporary-role command for?

Assign a role to a user for a specified duration.

When to use it

Reach for /temporary-role when you need a repeatable administrative action without clicking through Discord's settings by hand. Venon Security watches the syntax, the permissions and the context, and the execution can later be tied to the moderation logs or the module's configuration.

Required permissions

The command requires the scope: Manage Roles. If Discord rejects the action, check the bot role's position in the hierarchy, the permissions on the channel and whether the module is enabled in the dashboard.

Syntax

Syntax of the /temporary-role command

Format

/temporary-role <user> <role> <duration> [reason] [private]

Angle brackets mark required parameters, square brackets optional ones. In slash commands Discord suggests the fields for you, so it is best to fill them straight from the suggestion list.

Example usage

/temporary-role user:@nick role:@role duration:value reason:spam and insults private:yes

Treat the example as a template. Swap the member, channel, role, reason or duration for the real situation on your server.

Parameters

Command parameters

useruserrequired

Person who should receive the temporary role

rolerolerequired

Role to assign

durationtextrequired

Duration, for example: 15m, 2h or 7d

reasontextoptional

Reason for assigning the role

privateyes/nooptional

Only you can see the response

Problems

The most common problems

Missing permissions

Check whether the member and the bot both hold the required scope: Manage Roles.

Role hierarchy

For actions on members, the bot's role has to sit above the target's role.

Module disabled

If the command depends on a module, enable it in the dashboard and check the channel configuration.

Ready?

Add Venon Security and use /temporary-role with the full context

Slash commands work best alongside the dashboard, the logs and the protection modules. Add the bot to your server, read the documentation and set up your team's permissions.