UnitedUNITED
Getting started tutorial

Set Up United in a New Discord Server

A reliable setup starts with Discord permissions and one working log channel. Add advanced protection and ticket routing only after the basic path has been tested from event to recorded result.

Written and reviewed by Reno · August 27, 2026

Before you invite United

Choose the Discord server where you have authority to configure roles, channels, moderation, and integrations. Decide which staff members will validate the setup and where private bot activity should be recorded. United is free and does not require a paid feature tier, but Discord still requires a person with suitable server permissions to install and configure it.

The standard invite requests broad permissions so protection, moderation, tickets, roles, channels, transcripts, and repair can work together. You can later reduce permissions according to the features your server uses. Reducing them before validation makes failures harder to diagnose because the bot may be able to read a command while being unable to perform its result.

1. Put United's role in the correct position

Open Server Settings → Roles after the invite. Move United's highest role above every member and staff role it may need to timeout, kick, ban, strip, restore, mute, jail, or otherwise manage. Keep the human server-owner role and any roles United should never manage above it.

Discord role hierarchy is enforced even when a bot has Administrator. If United's role is below the target, a command can be accepted and still fail when Discord checks the action. Role position is therefore the first setup check, not a later troubleshooting trick.

2. Open the dashboard and review Permission Health

Use ,dashboard or the Dashboard link on the website and authorize with Discord. The server-owner dashboard shows servers owned by the signed-in account or servers where dashboard access was explicitly granted. It does not expose the private bot-owner console.

Select the new server and open Permission Health. View Audit Log is essential for attributing structural changes. Manage Messages supports cleanup and spam controls. Moderate Members supports timeouts. Manage Roles and Manage Channels support role workflows, ticket setup, lockdown, and repair. Kick Members and Ban Members are needed only when those results are configured.

3. Create one dependable Bot Logs channel

Set one private channel as Bot Logs through Dashboard → Setup → Logs or with ,logs #bot-logs. Confirm United can view the channel, send messages, embed links, and attach files. This channel becomes the default record for moderation, protection, member, server, configuration, and ticket activity.

Do not begin by creating a separate destination for every event. Specialized channels are useful only after the default path works. When a dedicated route is removed, United sends that event group back to Bot Logs.

4. Apply the baseline protection setup

Open Protection Setup or run ,protection setup. Review the generated defaults rather than treating them as a finished security policy. Start Anti-Spam with a reversible response such as message deletion or a short timeout. Review account-age and join thresholds before enabling Anti-Raid enforcement. Confirm View Audit Log and role hierarchy before enabling an aggressive Anti-Nuke punishment.

Keep whitelists narrow. A whitelisted person, bot, or trusted role can bypass applicable automatic protection. Do not whitelist a general member role, a cosmetic role, or a role granted automatically to every staff member.

5. Run controlled tests

TestExpected resultWhat to inspect
Run a harmless moderation command on a test account below UnitedDiscord accepts the actionTarget, moderator, reason, duration, and one Bot Logs record
Repeat a message within the configured Anti-Spam thresholdThe selected response occurs onceDeleted message, timeout if configured, and one protection log
Change a disposable test channel or roleUnited reads the event and audit actorAttribution, whitelist decision, hierarchy, and outcome
Restart or reconnect the bot during testingSaved settings and persistent controls returnTicket views, sticky roles, timeouts, and dashboard values

Use test roles and disposable channels. Do not simulate a destructive raid in a live community merely to prove protection works. The goal is to verify the event, attribution, response, and log chain with the smallest safe action.

6. Build tickets only after logs work

List the few reasons members actually contact staff, create one ticket type for each reason, select its destination category and staff roles, and add only questions that affect the first response. Publish the panel last. A public panel channel is not an open ticket and should never receive open-ticket controls during restart recovery.

Open a test ticket as a non-staff account. Confirm unrelated roles cannot see it, selected staff can respond, claim and close controls work, and a transcript reaches Bot Logs or the dedicated transcript destination before deletion. Use Refresh Panel for wording changes. Use Repair only when the saved panel is genuinely missing.

7. Review access and document the result

Grant dashboard access only to people who need it and remove access when responsibilities change. Dashboard controls still follow Discord permissions. If action logging is enabled, review the recorded server, actor, old value, and new value after a settings change.

Write down the chosen Bot Logs channel, transcript destination, ticket staff roles, protection responses, whitelist owners, and the staff member responsible for periodic review. A setup that only one person understands becomes fragile when that person is unavailable.

First-hour completion checklist

Continue to security setupOpen detailed documentation