Swivel Documentation
Everything you need to know about setting up, configuring, and mastering the Swivel Bot dashboard for your Discord server.
Quick Start
Get up and running in under 5 minutes. Follow these steps to add Swivel to your server and access the dashboard.
Invite the Bot
Click the Add to Server button on the homepage or use the invite link from our support server. Select the server you want to add Swivel to and authorize it.
Log in to the Dashboard
Visit the dashboard and sign in with your Discord account. You'll see all servers where you have Manage Server permission.
Select Your Server
Click on the server you want to configure. You'll land on the server overview page showing your server's stats and module statuses.
Enable Modules
Navigate to each module you want to use and click Enable. Every module starts disabled by default — you choose which features your server needs.
Moderation
A comprehensive moderation system with manual commands, moderation points, moderator role management, and detailed case tracking.
Mod Commands
Ban, kick, mute, warn, softban, and more — all with case IDs, reason tracking, and audit logging.
Points System
Assign points per action (warn = 1, mute = 2, etc.). Set thresholds to auto-escalate — e.g., auto-ban at 10 points.
Moderator Roles
Designate roles as moderators with per-command permissions. Control exactly which commands each role can use.
Case System
Every action creates a case with a unique ID. View, edit, or void cases. Full moderation log history.
Moderation Commands
| Command | Description | Permission |
|---|---|---|
| /ban | Ban a user (supports duration & message deletion) | Ban Members |
| /kick | Kick a user from the server | Kick Members |
| /mute | Timeout a user for a specified duration | Moderate Members |
| /warn | Issue a warning (recorded as a case) | Mod Role |
| /softban | Ban & immediately unban to purge messages | Ban Members |
| /purge | Bulk delete messages in a channel | Manage Messages |
| /case | View details of a specific case | Mod Role |
| /modlogs | View a user's full moderation history | Mod Role |
| /void | Void/invalidate a case | Mod Role |
| /role | Give or remove a role from a user | Manage Roles |
| /temprole | Assign a role for a set duration (auto-removed) | Manage Roles |
| /nick | Change a user's nickname | Manage Nicknames |
| /modstats | View moderation stats (warns, bans, kicks, mutes) | Mod Role |
| /lock | Lock a channel from sending messages | Manage Channels |
| /unlock | Unlock a previously locked channel | Manage Channels |
| /slowmode | Set channel slowmode duration | Manage Channels |
Utility Commands
General-purpose commands available to all members.
| Command | Description |
|---|---|
| !help | Show all available commands with categories |
| !ping | Check bot latency and API response time |
| !serverinfo | Display server information and statistics |
| !members [role] | Show member stats, or list all members with a specific role |
| !whois @user | View detailed user information and badges |
| !roleinfo @role | Show detailed role information |
| !roles | Display all server roles with member counts |
| !remind 1h Message | Set a reminder — bot DMs you when the time is up |
| !flip | Flip a coin (animated heads/tails) |
| !inviteinfo [code] | Look up details about a Discord invite |
| !vote | Get the bot's voting link |
AutoMod
Automated content moderation that runs 24/7. Configure filters, actions, immune roles, and more — all from the dashboard.
Bad Words Filter
Block offensive language with custom word lists and/or a built-in premade list of derogatory terms. Whitelist words you want to allow.
Spam Detection
Detect rapid message sending. Configure the threshold (e.g., 5 messages) and time window (e.g., 10 seconds).
Link Filter
Block all links or whitelist specific domains. Prevents phishing, advertising, and unwanted URLs.
Invite Filter
Automatically detect and remove Discord invite links to prevent server advertising.
Ping Spam
Limit the number of mentions per message. Prevent mass-pinging and @everyone spam.
Image Filter
Control image/attachment posting in channels. Restrict media to specific roles.
Filter Actions
Each filter can be configured with one of these actions when triggered:
| Action | Description | Color |
|---|---|---|
| warn | Send a warning embed (auto-deleted after 8s) | ● Yellow |
| mute | Timeout the user for a configurable duration | ● Yellow |
| kick | Kick the user from the server | ● Red |
| ban | Permanently ban the user | ● Red |
Premade Bad Words List
The premade list is a curated set of common offensive and derogatory terms. You can enable it with a single toggle.
Enable the Premade List
In the Bad Words filter, check the "Use Premade Filter List" toggle. This merges a built-in word list with your custom words.
Whitelist Words (Optional)
If the premade list blocks words you want to allow (e.g., gameplay terms), add them to the Whitelisted Words field, one per line.
Add Custom Words
Add additional words to the Custom Filtered Words field. These are always checked regardless of the premade list toggle.
Logging
Track everything that happens in your server with 15 log categories and over 50 event types. Each category can be sent to its own channel.
Moderation
Bans, kicks, mutes, warns, timeouts, and message clears.
Members
Joins, leaves, nickname changes, avatar updates, and role additions/removals.
Messages
Deleted messages, edited messages, bulk deletes, and pin activity.
Channels
Channel creation, deletion, and updates including permission changes.
Voice
Voice joins, leaves, moves, mutes, deafens, and streaming activity.
AutoMod
AutoMod actions, rule creation, deletion, and updates.
Welcome System
Greet new members with customizable messages, auto-assign roles, send DMs, and log departures — all with rich embed support.
Welcome Messages
Send welcome messages to a channel when a member joins. Supports plain text and embeds with custom colors, images, and footers.
Leave Messages
Log when members leave with a goodbye message. Customize the channel and message format.
Welcome DMs
Optionally send a private DM to new members with server rules, links, or a personal greeting.
Auto Roles
Automatically assign roles to new members and bots. Supports delays, screening wait, and multiple roles.
Message Variables
Use these variables in your welcome/leave messages — they'll be automatically replaced:
| Variable | Replaced With |
|---|---|
{user} |
The user's mention (e.g., @JohnDoe) |
{username} |
The user's display name |
{server} |
The server's name |
{memberCount} |
Current server member count |
{tag} |
The user's tag (e.g., JohnDoe#1234) |
Applications
Create custom application forms for staff recruitment, events, or any purpose. Review submissions, approve or deny, and auto-assign roles.
Create an Application
Go to the Applications module and click Create Application. Give it a name and description.
Build Your Questions
Add questions using the form builder. Supports short text, long text, multiple choice, and yes/no fields. Set questions as required or optional.
Configure Settings
Set the review channel where submissions appear, the role to assign on approval, and max submissions per user.
Share & Manage
Members apply via a link or the /apply command. Review submissions with Approve/Deny
buttons directly in your review channel.
Reaction Roles
Let members self-assign roles by reacting to messages. Create panels with emojis mapped to roles.
Customizable Panels
Create embed messages with custom title, description, and color. Each emoji maps to a different role.
Toggle Behavior
Click to add, click again to remove. Or lock it so roles can only be added. Support for exclusive (one-of) role groups.
Auto Responder
Create automatic responses to specific triggers. Great for FAQs, fun responses, or server-specific info.
Trigger Types
Exact match, contains, or starts with — pick the matching behavior for each trigger.
Response Types
Plain text responses, embedded messages, or reactions. Supports the same variables as the welcome system.
Giveaways
Host giveaways with customizable duration, winner count, and entry requirements. Manage active and ended giveaways from the dashboard.
Timed Giveaways
Set a duration (minutes, hours, or days) and the bot handles the countdown and winner selection automatically.
Reroll Winners
Not happy with the result? Reroll to pick new winners from the same giveaway.
Server Settings
Global configuration for your server — prefix, accent color, moderation behavior, and more.
Command Prefix
Set a custom prefix for text-based commands (default: !). Slash commands always work
regardless.
Dashboard Appearance
Customize the dashboard accent color to match your server's branding. Affects buttons, links, and highlights.
DM on Actions
Toggle whether users receive a DM when they are warned, muted, kicked, or banned by AutoMod.
Ban Message Deletion
Configure how many days of a banned user's messages are deleted (0–7 days). Applies to both manual bans and AutoMod bans.
Permissions & Roles
Understand how Swivel's permission system works and how to configure moderator access.
Permission Hierarchy
Server Owner
Full access to everything. Cannot be restricted. Always bypasses all filters and permission checks.
Administrator Permission
Users with Discord's Administrator permission have full moderation access. These roles are automatically marked as moderator roles.
Configured Moderator Roles
Roles added via the dashboard's Moderation Roles tab. These have per-command
permissions — you can allow /warn but deny /ban per role.
Native Discord Permissions
Users with Discord's native permissions (e.g., Ban Members, Kick Members) can use the corresponding commands even without a moderator role.