# 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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://iko.itzleo.com/role-systems/role-menu.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
