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

# Income

> Create income sources, add role rules and bonuses, and preview what a member earns.

The **Income** page is where you decide who earns what. It has three parts: **Sources**, **Bonuses** and an **Example payout** preview.

> [!NOTE]
>
> **Image needed — `dashboard-income-overview.png`**
> Show the whole Income page: the Sources card at the top, the Bonuses card and the Example payout card.

## Sources

An **income source** is a named group of roles that pay from the same pool, such as "Police" or "Fire & Rescue". A member earns from **every** source they qualify for.

| Action | How |
| - | - |
| **Add a source** | Click **Add source**, name it, save. |
| **Rename or edit** | **Edit source** on the source. |
| **Reorder** | **Move up** / **Move down**. Order only affects display. |
| **Enable or disable** | **Enable** / **Disable**. A disabled source pays nothing. |
| **Delete** | **Delete**. This also deletes its role rules, and cannot be undone. |

Inside a source, **Add role** creates a primary rule.

> [!NOTE]
>
> **Image needed — `dashboard-income-sources.png`**
> Show the Sources card with two or three sources, each showing its status badge and the **Add role** button.

## Primary role rules

A primary rule pays a role a **daily amount**, from one source.

* A member can hold several roles in one source, but **only the highest-paying role counts**.
* A member in several sources receives the selected amount from **each** source.

**1. Add the rule**

Under the source, click **Add role**.

**2. Choose the role and amount**

Pick the Discord role and enter the **daily amount**.

**3. Save**

The rule appears under its source.

| Action | How |
| - | - |
| **Edit** | **Edit rule** to change the amount, source or priority. |
| **Disable** | **Disable** keeps the rule but pays nothing. |
| **Delete** | **Delete** removes it permanently. |

> [!NOTE]
>
> If a role is deleted in Discord, the rule shows **Role missing** and pays nothing. Recreate the role or delete the rule.

> [!NOTE]
>
> **Image needed — `dashboard-income-rules.png`**
> Show a source with several role rules listed, each with its daily amount and the Enable/Delete/Edit controls.

## Bonuses

A **bonus** is a role that pays on top of everything else, such as Booster or Donator. Every bonus a member holds is added.

* Bonuses are not attached to a source.
* Add one with **Add bonus** in the Bonuses card.
* Edit, disable and delete work the same way as primary rules.

## Example payout

At the bottom of the page, **Example payout** calculates what a member holding **every** configured role would earn. It shows:

* Primary income, bonus income and the daily total.
* A row per source, with the selected role and amount.
* A note when the daily cap applies.

Use it to catch a rule that is too high or too low before a real payout runs.

## Doing this from Discord

Every action on this page has a slash-command equivalent:

| Dashboard | Command |
| - | - |
| Manage sources | `/economy sources` |
| Manage role rules | `/economy roles` |
| Preview a member | `/economy roles member:<member>` |
| Preview the next payout | `/economy preview` |

See [Admin commands](https://docs.civicbot.app/commands/admin-commands.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.