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

# Set up Civic

> Invite Civic, sign in to the dashboard, and run your first payout.

FROM FIRST INVITE TO FIRST PAYDAY
Your economy starts here.
Add Civic to Discord, configure your economy in the dashboard, and let Civic take care of daily payouts.

[Add to Discord ](https://discord.com/oauth2/authorize?client_id=1558075547576442900\&scope=bot+applications.commands\&permissions=2147486720)
[Just the checklist ](https://docs.civicbot.app/quick-start.md)

## Before you start

* This guide is for **server administrators**. If you only want to use the economy, read the [Member guide](https://docs.civicbot.app/members/overview.md).
* You need the **Manage Server** permission to invite Civic and to open the dashboard.
* Setup happens in Discord and on the [Civic website](https://civicbot.app), so keep both handy.

## Invite Civic

**1. Open the invite link**

Go to the [Civic website](https://civicbot.app) and click **Add to Discord**.

**2. Authorize the bot**

Choose your server under **Add to server**, click **Continue**, review the
permissions, and click **Authorize**. You need **Manage Server** in that server.

**3. Check that Civic joined**

Return to your server and look for Civic in the member list.

> [!NOTE]
>
> **Image needed — `invite-authorize.png`**
> Show the Discord authorization screen with your server selected, and highlight the **Authorize** button.

Civic only requests the permissions it needs: **View Channels**, **Send Messages** and **Use Application Commands**. It does not request Administrator.

## Open the dashboard

**1. Sign in**

On the [Civic website](https://civicbot.app), click **Log in** and authorize with Discord.

**2. Pick your server**

Choose the server you just added Civic to. Servers you can manage are listed
automatically.

**3. Land on the economy**

You open on the server's **Economy** summary, with the configuration pages in the
sidebar.

> [!NOTE]
>
> **Image needed — `dashboard-first-view.png`**
> Show the first view after signing in: the server sidebar on the left and the Economy summary page.

## Configure the economy

Open **Settings** in the sidebar. Work through the sections below. Leave anything you are unsure about at its default.

### Currency

| Setting | What to set |
| - | - |
| **Name (singular / plural)** | What your currency is called, for example "Dollar" and "Dollars". |
| **Symbol** | The symbol shown with amounts, for example `$`. |
| **Decimal places** | How many decimals amounts show. `2` gives `12.34`. |

### Starting balance

Give new members a small amount so their wallet is not empty on day one. It is paid once, into their wallet, the first time they earn or act. Existing balances are never changed.

### Payout schedule

| Setting | What to set |
| - | - |
| **Time zone** | Your community's time zone. Civic pays on the server's own calendar day. |
| **Payout time** | The local time each day that Civic pays members, in `HH:mm` form. |
| **Pay into** | Whether income goes to the **bank** or the **wallet**. |
| **Daily cap per member** | Optional. The most any one member can earn per day. Blank means no cap. |
| **Automatic payouts** | Turn scheduled payouts on. |

### Member features

| Setting | What it controls |
| - | - |
| **Payout log channel** | Where Civic posts the payout summary. It needs to be able to view and send messages there. |
| **Wallet transfers** | Allows members to deposit and withdraw. |
| **Member payments** | Allows members to pay each other. |
| **View other members' balances** | Allows public balance lookups. |

Click **Save changes**. Settings that affect payouts ask for confirmation first.

> [!NOTE]
>
> **Image needed — `dashboard-economy-settings.png`**
> Show the full Economy settings page with the Currency and Payout schedule sections visible and filled in.

## Create income sources

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

1. Open **Income** in the sidebar.
2. Click **Add source** and give it a name, for example "Police".
3. Repeat for each staff area or pay group in your community.

> [!NOTE]
>
> **Image needed — `dashboard-income-sources.png`**
> Show the Income page with two or three sources listed, each with an **Add role** button.

## Add role income

For each role that should earn money, add a rule with a daily amount.

1. Under a source, click **Add role**.
2. Pick the Discord role and enter the **daily amount**.
3. Repeat for each role.

You can also add **bonuses**: roles that pay on top of everything else, such as a Booster or Donator role.

**Primary income**

<ul>
  <li>Belongs to a source.</li>
  <li>Only the highest-paying role in a source counts for one member.</li>
  <li>Different sources add together.</li>
</ul>

**Bonuses**

<ul>
  <li>Not tied to a source.</li>
  <li>Every bonus a member holds is added.</li>
  <li>Applied after primary income.</li>
</ul>

> [!NOTE]
>
> **Image needed — `dashboard-income-rules.png`**
> Show several role rules under a source with their daily amounts, plus at least one bonus rule.

## Check before the first payout

Civic shows an **Example payout** at the bottom of the **Income** page. It calculates what a member holding every configured role would earn, so you can spot a rule that is too high or too low.

When you are happy, leave the payout schedule enabled. Civic pays automatically at your chosen time.

**1. Wait for the payout time**

Civic pays once per day at the time you set. Members see income after it runs.

**2. Check the payout**

Open **Payouts** in the sidebar to see the latest batch, how many members were paid,
and the total issued. Civic also posts a summary to your payout log channel.

**3. Ask a member to check**

Have a member run `/balance`, or run it yourself, to confirm the money arrived.

> [!NOTE]
>
> **Image needed — `dashboard-payouts.png`**
> Show the Payouts page after a successful run, with the next payout, the latest batch status set to COMPLETED and the batch history table.

## Troubleshooting

> [accordion] Civic isn't in my member list
>
> Make sure you picked the right server and completed Discord's authorization. If Civic still isn't there, open the [website](https://civicbot.app) and use **Add to Discord** again.

> [accordion] My role doesn't show when adding income
>
> Civic only lists roles it can see, and a role can only be used once. Roles managed by an integration, and the server's `@everyone` role, are not listed.

> [accordion] Nobody got paid at the payout time
>
> Check three things: **Automatic payouts** is on in Settings, **Time zone** and **Payout time** are set to your local values, and at least one role rule is enabled. See [Troubleshooting](https://docs.civicbot.app/help/troubleshooting.md).

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

## Next steps

> [card] [Dashboard](https://docs.civicbot.app/dashboard/signing-in.md)
>
> Every page and setting explained.

> [card] [Member guide](https://docs.civicbot.app/members/overview.md)
>
> Share this with your members.

> [card] [How payouts work](https://docs.civicbot.app/concepts/payouts.md)
>
> The payout pipeline, in plain terms.


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