Getting Started with BotForge
The Premier Discovery Hub for Discord Bots
Welcome to BotForge Docs
BotForge connects over 12,000 Discord communities with verified, production-ready bots. Whether you're a server admin looking to automate moderation or a developer ready to publish your creation, this guide walks you through account setup, verification, and your first deployment.
Our platform handles OAuth2 routing, uptime monitoring, and public analytics out of the box. You just focus on the code and community engagement.
Creating Your BotForge Account
Registration requires a valid Discord account linked to a verified email. We use a lightweight identity check to prevent spam listings and ensure developer accountability.
Step 1: Link Discord
Click "Sign in with Discord" on the dashboard. Grant BotForge the identify and email scopes. We never store your password or access your server messages.
Step 2: Verify Identity
Complete the CAPTCHA challenge and confirm your email address. Accounts created after March 2024 must also pass a 24-hour cooldown to prevent automated scraping.
Step 3: Configure Profile
Add a developer avatar, a short bio, and your primary GitHub repository. This information appears on your public bot listing and analytics dashboard.
Submit Your First Bot & Access Analytics
Once verified, you can immediately register a bot application and push it to the public directory. BotForge automatically tracks invite counts, guild retention, and command latency.
Register Application
Navigate to "Developer Portal" > "New Application". Enter your bot's name, icon, and a one-sentence description. Set the default permissions to Send Messages and Embed Links.
Publish to Directory
Toggle "Public Listing" to true. Your bot enters a 4-hour review queue where our moderation team checks for malicious intents, duplicate listings, and policy compliance.
Monitor Performance
Access the "Analytics" tab to view real-time invite graphs, server growth metrics, and uptime status. Export CSV reports or connect to your existing Grafana instance via webhook.
Frequently Asked Questions
How long does bot review take?
Standard listings are approved within 4 hours during UTC daytime. Applications flagged for manual inspection may take up to 48 hours. You'll receive a Discord ticket notification upon approval or rejection.
Can I list multiple bots under one account?
Yes. Free tier accounts support up to three active listings. Enterprise developers can request unlimited slots by submitting a support ticket with their company domain verification.
Do I need to pay for analytics?
Basic invite and uptime tracking is free for all verified developers. Advanced retention cohorts, command-level breakdowns, and historical data exports require the Pro tier at $9.99/month.
What happens if my bot violates TOS?
Listings using self-botting, token logging, or unauthorized data scraping are permanently delisted. Repeated violations result in a 90-day account suspension. Review our full Developer Policy for details.