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

# Ranking

> Role management, simplified - without granting the **manage roles** permission.

<Card title="Module: Ranking" icon="link" horizontal="True">
  Role management, simplified - without granting the **manage roles** permission.
</Card>

See **[this page](https://kyos.bot/ranks)** page for more!

## How does it work?

This system relies on **rank links.** A rank link is simple, it includes a **parent role** and **child(dren)** roles where anybody with the parent role may grant any of the child roles. For example, an **Administrator** needed to grant a member with the **Moderator** role,

This system allows for effective role management **without** ever granting the `manage roles` permission.

# Using the system

### Creating a rank link

<Tabs />

To create a new rank link, use the following command

<CodeGroup>
  ```javascript syntax theme={null}
  ,ranks add (parent) (children)
  ```

  ```javascript example theme={null}
  ,ranks add @Administrator @Moderator
  ```
</CodeGroup>

### Viewing Rank Links

<Tabs />

To view the **current rank links**, use the following command

<CodeGroup>
  ```javascript syntax theme={null}
  ,ranks list
  ```

  ```javascript example theme={null}
  ,ranks list
  ```
</CodeGroup>

<Tabs />

<Frame>
  <img src="https://mintcdn.com/kyos-c60486ad/AalZmPvrgh2Es8UR/images/rlist.png?fit=max&auto=format&n=AalZmPvrgh2Es8UR&q=85&s=6e56998c61f35c1d33923af15257c91c" width="1166" height="218" data-path="images/rlist.png" />
</Frame>

# Granting/Revoking Roles

### Giving a role

<Tabs />

To grant a role through this system, use the following command. Ensure you have the **required parent role**

<Warning>
  Members with the `administrator` permission **bypass** parent role checks - fake permissions don't bypass it, however.
</Warning>

<CodeGroup>
  ```javascript syntax theme={null}
  ,ranks grant (member) (role)
  ```

  ```javascript example theme={null}
  ,ranks grant @kk.apo Moderator
  ```
</CodeGroup>

### Revoking a role

<Tabs />

To remove a role from a member, use the following command

<CodeGroup>
  ```javascript syntax theme={null}
  ,ranks revoke (member) (role)
  ```

  ```javascript example theme={null}
  ,ranks revoke @kk.apo Moderator
  ```
</CodeGroup>

# ⭐ Premium Customisation

### Custom Messages

<Tabs />

With **[premium](http://docs.kyos.bot/premium)**, you may customise the **grant** and **revoke** message entirely!

### Grant Message

To customise the `ranks grant` message, use the following command

<CodeGroup>
  ```javascript syntax theme={null}
  ,ranks promotemessage (embed code)
  ```

  ```javascript example theme={null}
  ,ranks promotemessage (embed code)
  ```
</CodeGroup>

### Revoke Message

To customise the `ranks revoke` message, use the following command

<CodeGroup>
  ```javascript syntax theme={null}
  ,ranks demotemessage (embed code)
  ```

  ```javascript example theme={null}
  ,ranks demotemessage (embed code)
  ```
</CodeGroup>

### Ignoring Hierarchy

To **ignore** the role hierarchy when granting ranks, use the following command

<CodeGroup>
  ```javascript syntax theme={null}
  ,ranks ignorehierarchy (enable/disable)
  ```

  ```javascript example theme={null}
  ,ranks ignorehierarchy enable
  ```
</CodeGroup>