> For the complete documentation index, see [llms.txt](https://docs.ritabot.gg/ritabot-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ritabot.gg/ritabot-docs/usage-commands-and-settings/new-commands/quick-setup.md).

# Quick Setup

{% hint style="info" %}
If you need help at any point join our [**Discord Server**](https://discord.gg/mgNR64R) and someone will help you.
{% endhint %}

RITA - All-in-One Builder\\

\
This tool will guide you through creating a category, adding translation channels, creating the required roles, configuring permissions, and optionally creating a reaction role message so users can access the channels.

{% stepper %}
{% step %}

## Run the /quicksetup command.

<figure><img src="/files/wFTCJxysjKP8d03tgfcI" alt=""><figcaption></figcaption></figure>

***

{% endstep %}

{% step %}

## Creating / Selecting a Category&#x20;

<figure><img src="/files/aGCoL97LOrTEvYWLjNL5" alt=""><figcaption></figcaption></figure>

One of RITA's best practices is to keep all translation channels organised inside a category. To help keep your server tidy, `/quicksetup` requires you to either create a new category or select an existing one.

Click `Create/Select Category`. You'll then be asked to either create a new category or choose an existing one. In this example we'll create a category called **Instruction Demo**, but you can name it whatever you like.

***

<figure><img src="/files/8DIUWYzdVFtQJyf8sGgO" alt=""><figcaption></figcaption></figure>

***

{% endstep %}

{% step %}

## Channel Creation

<figure><img src="/files/dmQG60CX3Wht4sDDBXci" alt=""><figcaption></figcaption></figure>

Next we'll create your translation channels. You can create up to **20 channels** in a single run.

You'll be asked to:

* Enter a name for the channel. In this example we'll use **demo**.
* Select the languages you'd like to use. In this example we'll choose **English, French, German and Spanish**.

***

<figure><img src="/files/RLQNQnXCga6C1j3JV9Tl" alt=""><figcaption></figcaption></figure>

***

{% endstep %}

{% step %}

## Role Creation

<figure><img src="/files/heBHddQlvYZwpCaESfw0" alt=""><figcaption></figcaption></figure>

Next we'll create the Discord roles used to access each language channel.

Discord roles control what members can see and do within your server. RITA uses language roles so members only see the channels for the languages they've chosen, helping keep your server organised and easy to navigate.

***

You'll have two options and one optional setting.

First, choose whether you want your language roles to use **full language names** or **abbreviations**.

<figure><img src="/files/I8aS8HHSj0fMoNyIreEZ" alt=""><figcaption></figcaption></figure>

Next, choose whether you'd like to add a prefix before each role name.

<figure><img src="/files/ms14ldperH1jhpJQuyDs" alt=""><figcaption></figcaption></figure>

In this example we'll use `Full Name` and add `Demo` as the prefix.

***

{% endstep %}

{% step %}

## Permissions

<figure><img src="/files/5n6wd1lYPrdg6rgNaKfQ" alt=""><figcaption></figcaption></figure>

Next you'll choose which permissions members receive when they are assigned a language role.

***

* **View Channel** – Allows members to see the channel.
* **Send Messages** – Allows members to send messages.
* **Read Message History** – Allows members to read previous messages.
* **Add Reactions** – Allows members to react with emojis.
* **Attach Files** – Allows members to upload files and images.
* **Embed Links** – Allows members to send links that display as embeds.

<figure><img src="/files/CnX9xPFD4N0rFLdhk23y" alt=""><figcaption></figcaption></figure>

***

{% endstep %}

{% step %}

## Reaction Role

<figure><img src="/files/2xwbBjaMM2J8uvqt3eMI" alt=""><figcaption></figcaption></figure>

Reaction roles are a simple way for members to choose which language roles they'd like to receive.

If you'd like to create a reaction role message now, click `Create Message`. You can always create one later if you prefer.

If you don't want to create one now, click `Do Not Make Message`.

***

You'll then be asked to choose between two message styles:

<figure><img src="/files/n5AaTmBd4wvfLmhwQPab" alt=""><figcaption></figcaption></figure>

**Embed** – A cleaner, more modern appearance.

<figure><img src="/files/FUSjHLYdRs78QQeLpAkV" alt=""><figcaption></figcaption></figure>

**Plain Text** – A simpler text-only message.

<figure><img src="/files/2DRjCiy2iVelooIjO1lT" alt=""><figcaption></figcaption></figure>

***

<figure><img src="/files/u78x6XEMZU1ArDP59xW9" alt=""><figcaption></figcaption></figure>

***

{% endstep %}

{% step %}

## Summary

<figure><img src="/files/TqTCWmpyKzfrHARbagob" alt=""><figcaption></figcaption></figure>

Once the setup is complete, RITA will display a summary showing everything that was created, including the category, channels, roles, permissions and reaction role message (if selected).
{% endstep %}
{% endstepper %}

{% hint style="info" %}
If you need help at any point join our [**Discord Server**](https://discord.gg/mgNR64R) and someone will help you.
{% endhint %}


---

# 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://docs.ritabot.gg/ritabot-docs/usage-commands-and-settings/new-commands/quick-setup.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.
