# 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>](https://invomagic.gitbook.io/ticketsdocs/utility/autorole/autoroles-v1)

## 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="https://3692396313-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FETXJvJdkZBK73uujCnOn%2Fuploads%2FhY5w8Op6gfeEGPNIhgMX%2Fimage.png?alt=media&#x26;token=536b1e01-eff4-45a6-87c6-ae708d8956a0" 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="https://3692396313-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FETXJvJdkZBK73uujCnOn%2Fuploads%2FXED72M7XcbYk8vygAdKA%2FScreenshot%202025-10-25%20at%203.45.24%E2%80%AFPM.png?alt=media&#x26;token=a47b5378-7509-4cd6-9ead-80fd59ed053b" 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="https://3692396313-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FETXJvJdkZBK73uujCnOn%2Fuploads%2F6PIgARNWI9559eoYPlBy%2FScreenshot%202025-10-25%20at%203.51.13%E2%80%AFPM.png?alt=media&#x26;token=2272f5af-de57-459f-bf62-0218ec6a5c7d" 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="https://3692396313-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FETXJvJdkZBK73uujCnOn%2Fuploads%2FQGjBh4kWlBSRfWHNSWby%2FScreenshot%202025-10-25%20at%203.53.38%E2%80%AFPM.png?alt=media&#x26;token=868270b3-256c-46a4-bda8-357b3b079e9c" 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="https://3692396313-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FETXJvJdkZBK73uujCnOn%2Fuploads%2F9GEOF3yV1YFF7z714ugu%2Fimage.png?alt=media&#x26;token=561ab78a-a43a-4933-afb3-86a8bbdfad09" 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="https://3692396313-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FETXJvJdkZBK73uujCnOn%2Fuploads%2FlQwujT8xYroEapqSCYw1%2FScreenshot%202025-10-25%20at%203.56.13%E2%80%AFPM.png?alt=media&#x26;token=a07eb71f-ac0f-4df6-92b0-72e2d118d602" 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
