> For the complete documentation index, see [llms.txt](https://invomagic.gitbook.io/ticketsdocs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://invomagic.gitbook.io/ticketsdocs/utility/autorole.md).

# AutoRole

AutoRoles are Roles that are Instantly & Automatically added to a user when they join your server, this is useful for things such as Default Roles, Member Roles, Unverified Roles, Etc etc

[<sup><sub>*<mark style="color:$info;">Looking for the old AutoRole System? Click here</mark>*<sub></sup>](/ticketsdocs/utility/autorole/autoroles-v1.md)

## AutoRole Configuration

To set up AutoRoles for your server, run the `/autorole config` to open the settings menu which will allow you to add, remove, view, and purge AutoRoles.

<figure><img src="/files/uW6f7Ea5CjBd86Z99iIh" alt="" width="509"><figcaption></figcaption></figure>

### Adding AutoRoles

{% hint style="warning" %}
Adding a role with moderation permissions to the AutoRoles is **highly unrecommended** and could lead to server nukes
{% endhint %}

{% hint style="info" %}
Ensure that the bot has the correct permissions and is **Above the role you want to add**, it will not work otherwise
{% endhint %}

Using the menu, select **"Add an AutoRole"**, this will open a menu of all the roles in your server and you can select up to 25 (or more, depending on your plan) of them to add as AutoRoles, these roles will be granted to any new members that join your server by the bot.

<figure><img src="/files/CTxzaHMEN8oQczhvp34g" alt="" width="563"><figcaption></figcaption></figure>

### View AutoRoles

To view a list of all AutoRoles you currently have in your server, select "View AutoRoles" in the config menu, this will display each AutoRole that is currently active in your server along with their indexes (which are needed for deleting AutoRoles), to display all your AutoRoles as raw role IDs, press the "View RAW" button below the message.

<figure><img src="/files/uwcPNLbsHcDlXl4bNtuq" alt="" width="563"><figcaption></figcaption></figure>

### Deleting AutoRoles

{% hint style="info" %}
To get the index of an autorole, use the "View AutoRoles" feature
{% endhint %}

To delete an AutoRole, choose "Delete AutoRole" in the config menu, then press the "Remove AutoRole" button and enter the index of the AutoRole you'd like to delete, which will remove the AutoRole from your server and will no longer grant it when a new member joins your server.

<figure><img src="/files/6pZrgmBfYywv2UhIOi9z" alt="" width="563"><figcaption></figcaption></figure>

### Purging AutoRoles

{% hint style="danger" %}
Purging all your AutoRoles is destructive and cannot be undone/reversed, nor can we do so for you
{% endhint %}

To mass delete/purge all of your AutoRoles, select "Purge All AutoRoles" in the config menu, and you must enter a prompt to confirm the action, which will **Delete all of your AutoRoles** and none will be granted by the bot when a user joins your server.

<figure><img src="/files/bE6M9CPrHuFUOorqLa3e" alt="" width="489"><figcaption></figcaption></figure>

## How it works

Whenever a user joins the server, it'll add the AutoRoles selected to them automatically as shown in the images below

<figure><img src="/files/NBo0HNU93D5vIq8dDVtL" alt="" width="563"><figcaption></figcaption></figure>

### Limits

FREE Servers can add up to 25 AutoRoles\
**TicketsPRO** Servers can add up to **125** AutoRoles\
\
There are no limits on how many times Tickets will apply the AutoRoles


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://invomagic.gitbook.io/ticketsdocs/utility/autorole.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.