Getting started
Guild Ledger audits every change in your Discord server, runs approval workflows, and keeps a per-guild financial ledger — all from a small set of slash commands.
1. Add the bot
Add Guild Ledger to your server from the Discord App Directory. You need the Manage Server permission in the server you're adding it to.
2. Run /setup
On a new server, /setup asks just four questions — what the server is for, where alerts go,
who your staff are, and whether you track a currency — then previews every change and saves it all
at once:
- Server type — pick one or more archetypes (⚔️ Moderation, 💰 Economy, 🏘️ Community) that choose smart presets for everything else
- Alerts channel — the one genuinely required field
- Staff roles — approvers, plus treasurers if you track a currency
- Economy opt-in — skipped automatically if you picked the 💰 Economy archetype
Every run after first-run opens a health dashboard — live diagnostics with one-click fixes,
quick-enable rows, a permission preflight, and a test-alert button. See the
/setup docs for the full walkthrough, and use /config to revisit
any setting at any time.
3. Learn the command surface
| Command | Who it's for | What it does |
|---|---|---|
/setup | Admins | Four-question onboarding + health dashboard |
/config | Admins | Settings hub for everything after setup |
/alerts | Admins | Choose which of 43 audit events fire alerts |
/mod | Admins | Audit log, member history, and inline actions |
/export | Admins | CSV exports of any stored data |
/forms | Admins | Build and manage approval forms |
/request | All members | Member console: forms, disputes, wallet |
/ledger | Admins | Guild finances: entries, disputes, stats |
/activity | All members | Vote in polls and review your vote history |
/polls | Admins | Create polls and collect member votes |
/reaction-roles | Admins | Emoji-reaction role self-assignment |
Inside Discord, /help shows the same topics in an interactive menu, and /about explains what
data the bot stores. /support links to the support server.
Free vs. Pro
The free tier covers audit logging, moderation tools, up to 2 active approval forms, polls, the core ledger, and member wallets. Guild Ledger Pro unlocks unlimited forms, higher caps, wallet interest and budgets, scheduled reports, webhooks, ledger automation, and per-event alert routing. Pro features are marked 🔒 throughout these docs.