AzraGetting Started
Get Azra running in your server and configured in under 5 minutes.
On this page
Quick Start#
Five steps from zero to a fully configured server.
-
1
Invite the Bot
Click Add to Discord on the landing page and select your server. Grant Administrator permission for full functionality — anti-nuke, channel recovery, and captcha need elevated access.
-
2
Bot Auto-Provisions Your Server
On first join the bot automatically:
- Creates a guild record in the database
- Grants a free 1-month Pro trial with all features unlocked
- Takes an automatic snapshot of your server structure (channels & roles) — run
/snapshot takeany time for a full backup that also includes emojis, stickers, AutoMod rules, events and server settings - Sets up default moderation configuration
-
3
Sign In to the Dashboard
Visit the dashboard URL and click Sign In with Discord. After OAuth, you'll see all servers where you have Manage Server permission. Click your server to open its config panel.
-
4
Configure Features
Each feature has its own dashboard page. Navigate via the sidebar to set up moderation rules, welcome messages, leveling, tickets, and more. Changes save instantly — no bot restart required.
-
5
Set Up Mod Logging (Recommended)
Go to Server Config and configure a moderation log webhook. Every action — warn, ban, kick, automod trigger — will be posted there as a rich embed. You can route each event type to a different channel.
What happens when the trial ends#
How Sign-In Works#
Discord OAuth2 — no password stored, no separate account needed.
The dashboard uses a server-side session cookie. Your Discord access token is never sent to the browser — only your username, avatar, and user ID.
Dashboard Pages#
Every feature has a dedicated configuration page. No commands needed for setup.
Every page, and what you configure#
| Page | Route | What You Configure |
|---|---|---|
| Modules | /dashboard/:id/modules | Every feature on one screen — what it does, what is running here, and one-click recommended setup |
| Server Config | /dashboard/:id | Mod log webhook, per-event routing, subscription card, admin log viewer |
| Auto Moderation | /dashboard/:id/automod | Native AutoMod filters (word presets, links, invites, mentions, caps), anti-spam and blocked words — plus the 180+ rule engine: anti-raid/nuke, spam, text abuse, links, images, attachments, voice, usernames, profiles; per-rule modes, punishments, exceptions, escalation & test mode |
| Punishments & Cases | /dashboard/:id/punishments | Moderators, escalation ladders, case history, saved reasons, moderation settings |
| Security | /dashboard/:id/security | Anti-nuke limits, raid protection, bot detection, captcha, copy-paste guard, verification |
| Leveling | /dashboard/:id/leveling | XP rates, cooldown, level-up messages, level roles, rank card backgrounds |
| Welcome | /dashboard/:id/welcome | Embed/image/text welcome & goodbye, layered image designer, auto-roles, DM welcome |
| Tickets | /dashboard/:id/tickets | Departments, forms, SLAs, staff, automation, panels, knowledge base, analytics — see the ticket docs |
| Reaction Roles | /dashboard/:id/reaction-roles | Build reaction, button, and dropdown role panels visually |
| Giveaways | /dashboard/:id/giveaways | Create & manage giveaways, bonus entries, server-wide defaults |
| Social | /dashboard/:id/social | Twitch and YouTube integration management |
| Analytics | /dashboard/:id/analytics | 30-day charts: members, messages, joins/leaves, mod actions |
| Sticky | /dashboard/:id/sticky | Per-channel sticky message setup |
| Channels | /dashboard/:id/channels | Create, edit, and delete channels; manage webhooks |
| Subscription | /dashboard/:id/subscription | Start or renew Pro, pick duration, secure checkout |
Who can open the dashboard#
Text Commands (Prefix & @Mention)#
Most features are configured from the dashboard and used via slash commands, but a curated subset of everyday commands also works as plain text — triggered by your server's prefix or by @mentioning the bot.
Two ways to trigger#
!ban @user spamming
@Azra ban @user spamming
Both forms run the exact same logic as the slash command — same subscription gate, same permission checks, and the same entries in your moderation log and audit trail.
Changing your prefix#
-
1
From Discord
Run
!prefix ?(or@Azra prefix ?) to set the prefix to?. Requires Manage Server. Run!prefixwith no argument to view the current one. -
2
From the Dashboard
Go to Server Config and update the prefix field (1–10 characters, no spaces). Changes apply within a few seconds.
Available Text Commands#
Run !help in your server for the live list. Anything that needs a pop-up form (mass-mod, rank-card background, creating a giveaway) stays slash-only.
| Command | Aliases | Description |
|---|---|---|
| Moderation | ||
warn <@user> <reason> | — | Warn a member — counts toward escalation. Flags: --for 30d, --category spam, --silent, --note. |
warnings <@user> | warns | A member's warnings and where they stand on the ladder. |
kick <@user> <reason> | — | Kick a member. |
ban <@user|id> <reason> | — | Ban a user (optional --days 1 to purge messages). |
unban <id> <reason> | — | Lift a ban. |
timeout <@user> <duration> <reason> | — | Timeout a member (e.g. 10m, 1h30m, max 28d). |
untimeout <@user> [reason] | — | Remove a timeout. |
mute <@user> [reason] / unmute | — | Voice server-mute / un-mute — not a timeout. |
deafen <@user> [reason] / undeafen | — | Voice server-deafen / un-deafen. |
disconnect <@user> [reason] | — | Disconnect a member from voice. |
softban <@user> <reason> | — | Ban then immediately unban — removes the member and purges their messages. |
jail <@user> <reason> / unjail | — | Strip manageable roles into the jail role; unjail restores them. |
blacklist <@user|id> <reason> / unblacklist | — | Remove the user again on every join (kick or ban mode, set on the dashboard). |
case <view|history|list|note|reason|undo|escalation> | cases | Read and correct the moderation record. |
purge <1-100> [@user] | clear | Bulk-delete recent messages. |
slowmode <10s|1m|10m|seconds|remove> | — | Set channel slowmode (max 6h); remove disables it. |
lock [reason] / unlock [reason] | — | Lock or unlock the current channel. |
pin [id|link] / unpin [id|link] | — | Pin or unpin a message — reply to it, or pass its ID / link. |
thread [reply|current] [--private] <name> | — | Start a thread from a reply, the command message, or a message ID / link. |
nick <@user> [nickname] | — | Change or reset a member's nickname. |
addrole <@user> <@role|name> / removerole | giverole, takerole | Give or take a role. |
| Leveling | ||
rank [@user] | — | Show a rank card. |
level [@user] | lvl, xplevel | The same rank card as !rank. |
profile [@user] | pf | Full profile card — banner, prestige, badges, stats and dates. |
leaderboard | lb, top | Top 10 XP leaderboard. |
rewards | levelrewards | The level rewards this server hands out. |
prestige [status|confirm|rewards|leaderboard|history|settings] | — | Prestige once you reach the max level. status is the default; settings is the admin view. |
xp give|remove|set|reset|multiplier | — | Admin XP tools — the text twin of /xp. |
Giveaways (manager-gated; list open to all) | ||
giveaway list | gw, ga | List active, paused & scheduled giveaways. |
giveaway end <id> | gw, ga | End now and draw winners. |
giveaway reroll <id> [@user] | gw, ga | Reroll all winners, or one. |
giveaway pause <id> / resume <id> | gw, ga | Pause or resume (time preserved). |
giveaway extend <id> <duration> | gw, ga | Add time, e.g. 1h30m (max 60d). |
giveaway cancel <id> | gw, ga | Cancel with no winners. |
| Utility | ||
ping | — | Check bot latency. |
stats | — | Server analytics & moderation summary. |
prefix [new-prefix] | — | View the prefix, or change it (Manage Server). |
help [command] | commands, h | List every text command, or get details for one. |
ghostping <list|add|remove> [#channel] [message] | gp | Manage the ghost pings sent to new members. |
form <list|post> [name] | forms | List the server's forms, or post one as a button — forms are built and reviewed on the dashboard. |
Bot Permissions#
What the bot needs and why.
| Permission | Why it's needed |
|---|---|
| Administrator | Required for anti-nuke (stripping roles), channel recovery, lockdown, and captcha role management. Can be narrowed per feature if you prefer. |
| Manage Channels | Lock/unlock, lockdown, channel recovery from snapshots |
| Manage Roles | Temprole, level roles, captcha verified role, anti-nuke role stripping |
| Ban Members | Ban, tempban, anti-nuke, raid protection ban action |
| Kick Members | Kick, raid protection kick, captcha kick on timeout |
| Moderate Members | Timeout command and auto-mod timeout action |
| Manage Messages | Purge, automod message deletion, sticky message repost |
| View Audit Log | Anti-nuke detection (reads audit log events) |
| Send Messages + Embed Links | Posting mod logs, rank cards, giveaway embeds, welcome messages |
| Add Reactions | Reaction role panels |