> ## Documentation Index
> Fetch the complete documentation index at: https://docs.celestia.rest/llms.txt
> Use this file to discover all available pages before exploring further.

# Role Info

> View detailed information about any server role

## Overview

Display comprehensive information about any role in the server including permissions, member count, color, position, and creation date.

***

## Command Usage

<CodeGroup>
  ```bash Syntax theme={null}
  ~role info <role>
  ```

  ```bash Examples theme={null}
  # Check by role mention
  ~role info @Admin

  # Check by role name
  ~r info moderator

  # Check by role ID
  ~r info 123456789012345678
  ```
</CodeGroup>

**Aliases:** `r info`

**Permissions:** Manage Roles

***

## Information Displayed

<CardGroup cols={2}>
  <Card title="Basic Info" icon="tag">
    Name, ID, color, and position in hierarchy
  </Card>

  <Card title="Settings" icon="gear">
    Mentionable, hoisted, and managed status
  </Card>

  <Card title="Members" icon="users">
    Number of members with this role
  </Card>

  <Card title="Permissions" icon="shield">
    All permissions granted by the role
  </Card>

  <Card title="Creation Date" icon="calendar">
    When the role was created (absolute and relative)
  </Card>

  <Card title="Role Icon" icon="image">
    Custom role icon if one is set
  </Card>
</CardGroup>

***

## Features

* **Flexible Search** — Find roles by mention, ID, or name
* **Full Permissions List** — See all permissions granted by the role
* **Member Count** — Shows how many members have this role
* **Color Display** — Embed uses the role's actual color
* **Icon Preview** — Displays role icon as thumbnail if available
* **Timestamps** — Shows creation date in both full and relative formats

***

## Understanding Role Properties

<Tabs>
  <Tab title="Mentionable">
    **Yes** — Role can be mentioned with @rolename\
    **No** — Role cannot be mentioned
  </Tab>

  <Tab title="Hoisted">
    **Yes** — Members with this role appear separately in the member list\
    **No** — Members appear in standard online/offline categories
  </Tab>

  <Tab title="Managed">
    **Yes** — Role is managed by a bot/integration (cannot be manually assigned)\
    **No** — Role can be manually assigned to members
  </Tab>
</Tabs>

***

## Permission Requirements

<Card title="User Permissions" icon="user">
  **Manage Roles** — Required to use this command
</Card>

***

## Notes

<Info>
  **Color Display**

  The embed will use the role's actual color, making it easy to verify the role's appearance at a glance.
</Info>

<Note>
  **Multiple Roles**

  If multiple roles have the same name, be more specific by using a role mention or the exact role ID.
</Note>
