> ## 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.

# Troubleshooting

> Fixes for the most common problems.

## Nobody was paid

> [accordion] Check that payouts are on and scheduled
>
> In the dashboard, open **Settings**. Confirm **Automatic payouts** is on, and that the **Time zone** and **Payout time** are set to your local values, not UTC.

> [accordion] Check that the economy is enabled
>
> **Economy enabled** must be on. When it is off, income and payouts pause.

> [accordion] Check that at least one rule matches
>
> On **Income**, confirm at least one enabled source has an enabled role rule, and that members actually hold that role. A rule for a role nobody has pays nothing.

> [accordion] Check the payout day has not already run
>
> Each server is paid at most once per local day. If it is before your payout time, the run is simply still to come.

> [accordion] Check for a failed batch
>
> Open **Payouts**. If the latest batch is **PARTIAL** or **FAILED**, the reason is shown under its status.

## A member is paid the wrong amount

> [accordion] Confirm which roles they hold
>
> Within a source, only the highest-paying role counts. Check the rules under that source and the role the member actually has.

> [accordion] Check the daily cap
>
> If a daily cap is set, it limits the member's total for the day, not each rule. The Income page shows when a cap applies.

> [accordion] Check for stale or missing roles
>
> If a role was deleted in Discord, its rule shows **Role missing** and pays nothing. Recreate the role or delete the rule.

> [accordion] Preview the calculation
>
> Run `/economy roles member:<member>` or open the member's page in the dashboard to see the exact breakdown.

## The preview looks out of date

> [accordion] Member data is stale
>
> Civic will not pay from old data. When the data is out of date, the **Payouts** page shows a warning and the preview may miss recent role changes. It clears after the next resync. See [Member sync](https://docs.civicbot.app/concepts/member-sync.md).

## A member cannot use a command

> [accordion] Wallet transfers are disabled
>
> `/deposit` and `/withdraw` need **Wallet transfers** enabled in Settings.

> [accordion] Member payments are disabled
>
> `/pay` needs **Member payments** enabled in Settings, and the sender needs enough in their **wallet**.

> [accordion] Public balance lookups are disabled
>
> Looking up another member needs **View other members' balances** enabled. A member can always see their own balance.

> [accordion] The account is frozen
>
> A frozen account cannot send or move money. An administrator can unfreeze it.

## An administrator cannot reach the dashboard

> [accordion] Check the permission
>
> Dashboard access needs **Manage Server**, **Administrator**, or server ownership. If it was just changed, wait about 15 seconds for Discord's cache to catch up.

> [accordion] Sign in again
>
> Sessions last 7 days. If the session has ended, sign in again from the [Civic website](https://civicbot.app).

## A server is missing from the dashboard

> [accordion] Refresh the list
>
> Click **Refresh servers** on the server list. Civic re-reads your server list from Discord.

> [accordion] Check installation
>
> If Civic is not in the server, the card shows **Not installed**. Click **Add Civic** to install it.

## Civic's messages are missing from a channel

> [accordion] Check channel permissions
>
> Civic needs **View Channel** and **Send Messages** in the payout log channel. Re-check the channel's permissions for Civic.

***

Still stuck? [Contact support](https://civicbot.app) with your server name and what you expected to happen.


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