GizmoBot Setup Guides
Step-by-step tutorials to help you master every feature
Quick Start
Invite GizmoBot
Visit the homepage and click "Add to Discord". Select your server and authorize the required permissions.
Access the Dashboard
Go to gizmobot.com/dashboard and sign in with Discord. Select your server from the list.
Configure Features
Navigate through the dashboard sidebar to enable and customize features for your community.
Start Using
Your bot is ready! Members can start using commands and interacting with features immediately.
Feature Guides
1. Enable Auto-Moderation
Go to Dashboard → Moderation → Enable the features you want:
- Spam Protection: Detects and deletes spam messages
- Caps Lock Filter: Removes messages with excessive caps
- Link Filter: Blocks unauthorized links
- Bad Words Filter: Filters profanity and custom words
2. Configure Media-Only Channels
Select channels where only images/videos are allowed. Text-only messages will be auto-deleted.
3. Set Up Warning System
Configure how many warnings trigger actions (mute, kick, ban). The bot automatically tracks warnings per user.
4. Add Custom Bad Words
In the Bad Words section, add terms specific to your community that should be filtered.
1. Enable Leveling
Go to Dashboard → Leveling → Toggle "Enable Leveling System"
2. Configure XP Settings
- XP per Message: How much XP users earn per message (default: 15-25)
- XP Cooldown: Time between XP gains to prevent spam (default: 60s)
- Level-Up Channel: Where to announce level-ups (or disable announcements)
3. Add Role Rewards
Click "Add Role Reward" and configure:
- Level requirement (e.g., Level 5, Level 10)
- Role to grant when users reach that level
- Whether to stack roles or replace previous ones
4. Customize Level-Up Message
Personalize the level-up message with variables: {user}, {level}, {xp}
Pro Tip: Use /rank to check your level and /leaderboard to see top members!
1. Enable Welcome Messages
Dashboard → Welcome → Toggle "Enable Welcome Messages"
2. Choose Welcome Channel
Select the channel where welcome messages will be sent (e.g., #welcome, #general)
3. Create Your Message
Use variables to personalize:
{user}- Mentions the new member{username}- User's name without mention{server}- Server name{membercount}- Total member count
4. Use Embed Builder (Optional)
Click "Use Embed" to create a rich welcome message with colors, images, and fields. Preview in real-time!
5. Configure Auto-Role (Optional)
Automatically assign roles to new members when they join (e.g., "Member" role)
6. Enable DM Welcome (Optional)
Send a private welcome message to new members with server rules or important info
1. Access Custom Commands
Dashboard → Commands → Click "Create New Command"
2. Configure Command Basics
- Command Name: What users type (e.g., "!info", "!rules")
- Description: What the command does
- Response: The message or embed to send
3. Use Variables
Make commands dynamic:
{user}- Command user{server}- Server name{channel}- Channel name
4. Set Permissions
Choose who can use the command: Everyone, Specific Roles, or Administrators only
5. Add Cooldowns (Optional)
Prevent spam by adding cooldowns (e.g., 30 seconds between uses per user)
Example: Create a !socials command that displays your social media links with custom branding!
1. Create a Reaction Role Message
Dashboard → Roles → Reaction Roles → Click "Create New"
2. Design Your Message
Write a message explaining which reactions give which roles. Use the embed builder for a professional look.
3. Add Reaction-Role Pairs
For each role you want to offer:
- Select the emoji (custom or default)
- Select the role to assign
- Click "Add Pair"
4. Choose Channel and Send
Select where to post the message (e.g., #roles) and click "Send". The bot will automatically add all reactions!
5. Configure Options
- Single Role: Users can only have one role from the group
- Multiple Roles: Users can select multiple roles
- Remove on Unreact: Auto-remove roles when users unreact
Common Use Cases: Color roles, game roles, notification preferences, pronouns, region roles
1. Choose Your Platform
Dashboard → Notifications → Select a platform (YouTube, Twitch, Instagram, TikTok, X, or Kick)
2. Add Channel/Profile
Enter the details:
- YouTube: Channel ID or handle
- Twitch: Username
- Instagram: Username (requires connection)
- TikTok: Username
- X (Twitter): Username
- Kick: Channel name
3. Select Notification Channel
Choose which Discord channel receives notifications (e.g., #announcements, #streams)
4. Customize Message
Use variables to personalize notifications:
{title}- Video/stream title{url}- Direct link{creator}- Channel/creator name{platform}- Platform name
5. Configure Notification Type
- YouTube: New videos and/or live streams
- Twitch: Live stream alerts
- Instagram: New posts
- TikTok: New videos
6. Add Role Mentions (Optional)
Ping specific roles when notifications are posted to ensure members don't miss content
Pro Tip: Create dedicated roles like "@YouTube Notifications" that members can self-assign!
1. Start a Giveaway
Use the command in your server:
!gstart [duration] [winners] [prize]Example: !gstart 7d 1 Discord Nitro
2. Duration Format
s- secondsm- minutesh- hoursd- days
3. Members Enter
Members react with 🎉 to enter the giveaway. The bot tracks all entries automatically.
4. End Giveaway
The bot automatically ends at the scheduled time. To end early:
!gend [messageId]5. Reroll Winners
If a winner doesn't respond, pick a new winner:
!greroll [messageId]6. Configure Requirements (Dashboard)
Dashboard → Giveaways → Set requirements like minimum account age, required roles, or server boosts
1. Enable Tickets
Dashboard → Tickets → Toggle "Enable Ticket System"
2. Create Ticket Categories
Set up categories like:
- General Support
- Report User
- Partnership Inquiry
- Bug Report
3. Configure Each Category
- Name: Category display name
- Emoji: Icon for the button
- Staff Roles: Who can view and respond
- Description: What this category is for
4. Create Ticket Panel
Design a message with buttons for each category. Send it to your support channel (e.g., #create-ticket)
5. Configure Settings
- Ticket Logs: Channel for ticket transcripts
- Max Open Tickets: Limit per user (prevent spam)
- Auto-Close: Close inactive tickets after X days
6. Staff Commands
Staff can use buttons in ticket channels to close, claim, or transfer tickets
1. Activate Premium
Purchase a premium subscription or redeem a license key in Dashboard → Premium
2. Access Personalizer
Dashboard → Bot Personalizer → Click "Create Custom Bot"
3. Add Your Bot Token
Create a bot at Discord Developer Portal:
- Create New Application
- Go to Bot section → Reset Token
- Copy the token and paste in GizmoBot dashboard
- Enable required intents (Message Content, Guild Members, Presence)
4. Customize Appearance
- Username: Your bot's name (changes in Discord Developer Portal)
- Avatar: Upload custom profile picture
- Status: Online, Idle, DND, or Invisible
- Activity: Playing, Watching, Listening, Streaming, or Custom status
5. Invite Your Bot
Use the generated invite link to add your custom bot to your server. It has all GizmoBot features!
6. Configure Features
All GizmoBot features work with your custom bot. Configure them the same way through the dashboard.
Note: Custom bots require an active premium subscription to stay online. If your subscription ends, your custom bot will go offline (but settings are saved).