> For the complete documentation index, see [llms.txt](https://iko.itzleo.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://iko.itzleo.com/role-systems/role-menu.md).

# Role Menu

![](https://i.imgur.com/uCmXU3u.png)

## Some notable features

* Have upto 25 roles in roles menu
* Fully customizable role menu embed

## Steps

1. Copy IDs of role you want to add to menu
2. Seperate them with comma and keep this role string handy
3. Next, use `/role_menu` command and pass the role string in `roles` argument and customize the embed as you want using other arguments
4. Press send/enter!

Done!

## Commands

#### `/role menu create` **: Create role menu**

> **Necessary Arguments :**
>
> * `placeholder` : Default text displayed in select menu
> * `roles` : Mention role IDs seperate by comma
> * `type` : If you want to remove user to be only assigned one of the role from roles you give?
> * `remall` : Whether to give an option to remove all the roles within role menu

> **Optional Arguments :**
>
> * `message` : Message to send with embed. Use /n for new line
>
> * `title` : Embed's title
>
> * `description` : Embed's description , for new line add `/n`
>
> * `color` : Embed's hex color (with #)
>
> * `title-url` : Embed's title's URL
>
> * `timestamp` : Display timestamp with embed.<br>
>
> * `set-author` : Set author of embed.
>
> * `set-author-icon` : Set icon URL of author.
>
> * `set-author-url` : Set URL for author's text.
>
> * `image` : Set embed's image
>
> * `thumbnail` : Set embed's thumbnail
>
> * `footer-text` : Set embed's footer text
>
> * `footer-icon` : Set embed's footer icon URL
>
> * `fields` : Set embed's fields

> **How to set embed's fields?**
>
> In embed's field there are three main things
>
> * Field name : name of the field
> * Field value : value of the field
> * Field inline : whether the field is inline or not
>
> Inline basically means if field is moved to new line or is adjusted with other fields in same line
>
> So, let's say if you wanna specify a field with name `test` having value `test value` and want it non-inline
>
> You need to type `test;test value;no`
>
> Now, let's add one more field with name `test2` having value `test value 2` and want it non-inline
>
> To add a new field you just need to seperate the previous one with `,` (comma)
>
> You need to type `test;test value;no,test2;test value 2;no`

#### `/role menu update` **: Create role menu**

> **Optional Arguments :**
>
> * `placeholder` : Default text displayed in select menu
>
> * `roles` : Mention role IDs seperate by comma
>
> * `type` : If you want to remove user to be only assigned one of the role from roles you give?
>
> * `remall` : Whether to give an option to remove all the roles within role menu<br>
>
> * `message` : Message to send with embed. Use /n for new line
>
> * `title` : Embed's title
>
> * `description` : Embed's description , for new line add `/n`
>
> * `color` : Embed's hex color (with #)
>
> * `title-url` : Embed's title's URL
>
> * `timestamp` : Display timestamp with embed.
>
> * `set-author` : Set author of embed.
>
> * `set-author-icon` : Set icon URL of author.
>
> * `set-author-url` : Set URL for author's text.
>
> * `image` : Set embed's image
>
> * `thumbnail` : Set embed's thumbnail
>
> * `footer-text` : Set embed's footer text
>
> * `footer-icon` : Set embed's footer icon URL
>
> * `fields` : Set embed's fields