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

# Join roles

<Info>
  Ensure kyos is **above** the role you want it give else your autoroles **will not work**
</Info>

## Adding an autorole

<Check>
  Any roles with **dangerous permissions** will **automatically** not be granted and removed by kyos if an autorole
</Check>

To add an autorole execute the following command

<CodeGroup>
  ```javascript Syntax theme={null}
  ,autorole add (role)
  ```

  ```javascript Example theme={null}
  ,autorole add @role
  ```
</CodeGroup>

<br />

<Frame>
  <img src="https://mintcdn.com/kyos-f3ac1380/bs-eQRildrKnDsGo/images/Screenshot2026-03-24182843.png?fit=max&auto=format&n=bs-eQRildrKnDsGo&q=85&s=bf17ea4399290a3932c7f13aa5819203" alt="Screenshot2026 03 24182843" width="546" height="158" data-path="images/Screenshot2026-03-24182843.png" />
</Frame>

## Removing an autorole

To remove an autorole, execute the following command. This will be permanently removed unless autorole add is executed again for the removed role

<CodeGroup>
  ```javascript Syntax theme={null}
  ,autorole remove (role)
  ```

  ```javascript Example theme={null}
  ,autorole remove @role
  ```
</CodeGroup>

<br />

<Frame>
  <img src="https://mintcdn.com/kyos-f3ac1380/bs-eQRildrKnDsGo/images/autorole-remove.png?fit=max&auto=format&n=bs-eQRildrKnDsGo&q=85&s=a1d990aeb24a8c4d51aac323e99c9e8c" alt="Autorole Remove" width="565" height="163" data-path="images/autorole-remove.png" />
</Frame>

## Viewing the autoroles

To view the current autoroles, simply execute the the following command

<CodeGroup>
  ```javascript Syntax theme={null}
  ,autorole view
  ```

  ```javascript Example theme={null}
  ,autorole view
  ```
</CodeGroup>

<br />

<Frame>
  <img src="https://mintcdn.com/kyos-f3ac1380/bs-eQRildrKnDsGo/images/autorole-view.png?fit=max&auto=format&n=bs-eQRildrKnDsGo&q=85&s=3f3b4ebd7190a1277f8f1c011c0dd84e" alt="Autorole View" width="521" height="306" data-path="images/autorole-view.png" />
</Frame>

## Clearing autoroles

To clear the current autoroles, execute the following command:

<Info>
  This will **permanently** remove **all autoroles** at once.
</Info>

<CodeGroup>
  ```javascript Syntax theme={null}
  ,autorole clear
  ```
</CodeGroup>
