Ledra Docs

Role commands

/joinrole and /rolemenu — automatic and self-assignable roles.


/joinrole add#

Grant a role automatically to everyone who joins. Administrator.

Option Required Description
role yes The role to grant
bots_only no Grant to bots instead of humans (default false)

Ledra needs: Manage Roles

/joinrole add role:@Member
/joinrole add role:@Bots bots_only:true

Maximum 10 join roles per server. Roles with Administrator, integration roles, and roles above Ledra's or your own highest role are refused.


/joinrole remove#

Option Required Description
role yes The role to stop granting

Members who already have it keep it.


/joinrole list#

Moderator. Join roles, split into members and bots.


/rolemenu create#

A new, empty menu. Administrator.

Option Required Description
title yes Headline, 1–200 characters
description no Description, 1–1000 characters
unique no Members may pick only one role from this menu

Ledra needs: Manage Roles

/rolemenu create title:Pick your colours unique:true
→ Created role menu #1

Note the ID — every other /rolemenu command needs it.


/rolemenu add#

Add a role to a menu. Administrator.

Option Required Description
menu yes Menu ID
role yes The role members can pick
label no Button text, 1–80 characters (defaults to the role name)
emoji no Emoji for the button
/rolemenu add menu:1 role:@Red emoji:🔴 label:Crimson

Maximum 20 roles per menu. Run /rolemenu publish afterwards to update the posted message.


/rolemenu remove#

Option Required Description
menu yes Menu ID
role yes The role to remove

Republish to update the message.


/rolemenu publish#

Post the menu, or refresh it after changes. Administrator.

Option Required Description
menu yes Menu ID
channel no Target channel (defaults to the current one)

Ledra needs: Manage Roles, Send Messages, Embed Links

/rolemenu publish menu:1 channel:#roles

Publishing an already-published menu to the same channel edits the existing message instead of posting a duplicate. If that message was deleted, a new one is posted.

Refuses if the menu has no roles yet.


/rolemenu list#

Moderator. Every menu with its ID, title, role count, location, and whether it is unique-pick.


/rolemenu delete#

Option Required Description
menu yes Menu ID

Deletes the menu and its posted message. Members keep roles they already picked.

Roles guide

Ledra documentation. Everything here describes the hosted bot.