# Discord Roles & Permissions Setup for Mochi

**Before** you dive into Mochi’s features, it helps to understand *how* **Discord roles** and **permissions** work — they’re what let Mochi do her job smoothly and securely.

#### <mark style="color:purple;">**What Are Roles and Permissions?**</mark>

Roles help organize your members into groups.\
Permissions decide what each group can do — like sending messages, managing channels, or controlling apps such as Mochi.

Think of it this way:

> 🎩  **Roles are the job titles** — like “**Admin**” or “**Moderator**.”\
> 🧰  **Permissions are the tools** that come with those titles.

Together, they form the structure that keeps your community running safely and efficiently.

#### <mark style="color:purple;">**Setting Mochi’s Role: The Basics**</mark>

You’ve got two easy options:

1. **Use Mochi’s default app role** — it already includes all the permissions she needs.
2. **Create a custom role just for Mochi** and grant it the required permissions manually.

{% hint style="success" %}

## 💡 **Important:**&#x20;

Make sure Mochi’s role sits **above** any roles she needs to manage or interact with.

\
This order (called the **role hierarchy**) lets Mochi perform actions — like assigning roles or moderating users — without running into permission issues.
{% endhint %}

#### <mark style="color:purple;">Setting Role Order (Hierarchy)</mark>

To raise Mochi’s role:

1. Open your <mark style="color:purple;">**Server Settings**</mark>**&#x20;→&#x20;**<mark style="color:purple;">**Roles**</mark>.
2. Drag <mark style="color:purple;">**Mochi’s role**</mark> above the roles she’ll manage.
3. Click <mark style="color:purple;">**Save Changes**</mark> at the top.

That’s it! Mochi now has the right permissions to keep things running smoothly.&#x20;

<div align="center" data-full-width="false"><figure><img src="https://i.imgur.com/LpZcOVI.gif" alt=""><figcaption></figcaption></figure></div>

#### <mark style="color:purple;">**Channel Permissions**</mark>

For Mochi to work **inside a channel**, she needs a few basic permissions:

* 📖 **Read Messages**
* 💌 **Send Messages**
* 🧹 **Manage Messages**

These allow Mochi to read commands, reply, and keep your channels tidy.

If Mochi isn’t responding somewhere, double-check that the channel’s settings aren't blocking these permissions for her app role.

{% hint style="warning" %}

## Note:

Channel-specific settings can override role permissions.

Even if Mochi’s main role ***looks*** fine, a single channel restriction might still stop her from working properly.
{% endhint %}

***

{% hint style="success" %}

## Want to Learn More?

If you’d like a deeper dive into Discord’s permission system, check out:  [Discord’s Official Guide on Roles & Permissions](https://support.discord.com/hc/en-us/articles/206029707-Setting-Up-Permissions-and-Role-Colors)

It’s a great way to make sure Mochi always has the right access to do her thing safely and smoothly.&#x20;
{% endhint %}


---

# Agent Instructions: 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:

```
GET https://docs.mochi.bot/getting-started/discord-roles-and-permissions-setup-for-mochi.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.