> ## 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.

# Join roles

<Card title="Module: Join roles" icon="right-to-bracket" horizontal="True">
  Setup automated roles kyos will give to new members that join your server
</Card>

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

## Adding an autorole

<Tabs />

<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 @User
  ```
</CodeGroup>

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/kyos-c60486ad/images/auto-add.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 @User
  ```
</CodeGroup>

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/kyos-c60486ad/images/auto-remove.png" />
</Frame>

## Viewing the autoroles

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

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

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/kyos-c60486ad/images/auto-list.png" />
</Frame>

## Clearing autoroles

To clear the current autoroles, execute the following command:

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

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