> ## Documentation Index
> Fetch the complete documentation index at: https://aiko.tenji.top/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Quota

> Setup quota for user, prevent one user from using up all the credits

User quota is a fairness cap — it limits how much of the **server's own monthly credit allowance** any single member can burn through, so one person can't use it all up for everyone else. It's a percentage of the server's plan, not a separate credit pool.

## Open quota settings

`/settings` → Usage → **Manage** next to **User Quota**

| Field                                  | Meaning                                                                                                         |
| -------------------------------------- | --------------------------------------------------------------------------------------------------------------- |
| **Default user quota (%)**             | Max share of the server's monthly credits each member may use. `-1` for unlimited, or a whole number **1–100**. |
| **Roles with a different quota**       | Pick roles that should get a different cap than the default. Optional.                                          |
| **Override quota (%) for those roles** | The cap applied to the picked roles. Only used when roles are selected.                                         |

<Info>
  The default quota is **20%** until you change it.
</Info>

## Override quota values

The override field accepts three kinds of input:

* **`-1`** — unlimited for the picked roles.
* **`1`–`100`** — that percentage, for the picked roles.
* **`0`** — removes the override entirely for the picked roles, falling back to the default quota.

<Tip>
  `0` is the only way to undo a role override once set — there's no separate "remove" button, just resubmit the form with the role picked and the override set to `0`.
</Tip>

<Note>
  If a member holds **multiple** overridden roles, the most generous one wins: an unlimited (`-1`) role beats any percentage, otherwise the highest percentage applies. Overrides are meant to grant elevated allowances (VIP/staff/booster-style roles), not to further restrict someone below the default.
</Note>

## What happens when a member hits their quota

Behavior differs by how they asked:

| Path             | What the member sees                       |
| ---------------- | ------------------------------------------ |
| `/aiko`          | An ephemeral reply — visible only to them. |
| @mention / reply | A normal, **public** reply in the channel. |
| Ticket assistant | Completely silent — no message to anyone.  |

The message tells them their personal share and percentage used, and that it resets at the next monthly reset. They can keep using Aiko once the server's credits reset, or a server admin raises their quota.

<Warning>
  This is a percentage of the *server's* plan limit, so it also stops applying once the server itself runs out of credits for the month — see [Plans and limits](/plan) for each plan's monthly allowance.
</Warning>

You need Discord's **Manage Server** permission to change quota settings.