> For the complete documentation index, see [llms.txt](https://infinitybot.gitbook.io/infinitybot-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://infinitybot.gitbook.io/infinitybot-docs/onboarding/auto-role.md).

# Auto Role

With the auto role system you can add a role to a user or bot when they join the server.

## Setup

You can select a role for this system with the `/toggle auto-role` command. 

| Command Option Name | Function                                                                                                                                         |
| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| action              | The action that you want to take. This can be selecting or removing a role. You can also select whether you want to enable it for users or bots. |
| your-auto-role      | In this option you can select the role that you want to use.                                                                                     |

#### Force Members to Have the Role

You can also enable the force feature. This feature, when enabled, will make sure all users have the role after they joined. This is useful for when the bot happends to miss a user, (Which is very rare) or if the role has been removed by someone.

When you use the `/setup auto-role` command, you will be asked if you want to enable this feature. Note that you can't use this feature on bot roles.

<figure><img src="https://2255898787-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZqXmdaTQZknKkvcG0Uxz%2Fuploads%2FIGO6p1PmmX4LH6tcwd5u%2Fimage.png?alt=media&amp;token=c726c7b9-1df6-4988-b6a2-092a81213811" alt=""><figcaption></figcaption></figure>