Creating Your Account

There are two ways to create an account on Build Discord Bots:

Option 1: Sign in with Discord (Recommended)
Click the "Sign In with Discord" button on the landing page. You will be redirected to Discord to authorize the application. This is the fastest way to get started — your Discord username and avatar will be imported automatically.

Option 2: Email & Password
Click "Sign Up" and fill in your username, email, and password. After registering, you will receive a verification email. Click the link in the email to activate your account. If you don't see the email, check your spam folder or use the "Resend Verification" option on the login page.

Your First Look at the Dashboard

Once you're logged in, you'll land on the Dashboard. If this is your first visit, you may see an interactive onboarding tour that walks you through the key features of the platform. The tour highlights:

• How to create your first bot
• Where to find and enable modules
• How to start and stop bots
• Where to manage your subscription

The sidebar on the left gives you access to all pages: Dashboard, New Bot, Templates, Module Builder, Marketplace, Seller Earnings, File Manager (Developer),Subscription, Referrals, Support, Changelog, Documentation, and Profile.

Before you can create a bot on our platform, you need to set one up on Discord's side. Follow these steps carefully:

The Dashboard is your central hub for managing all your bots. Here's what you'll find:

Statistics Cards

At the top of the dashboard, you'll see summary cards showing:

• Total Bots — how many bots you've created
• Running Bots — bots currently online
• Stopped Bots — bots that are offline
• Total Custom Commands — across all your bots

Bot Usage Progress Bar

Below the stats, a color-coded progress bar shows how many bot slots you're using. The bar changes color based on usage:

• Green (0–69%) — plenty of room
• Yellow (70–89%) — getting close to the limit
• Red (90–100%) — almost full or at capacity

Below the bar it shows how many bot slots you have remaining. If you're at the limit, you can upgrade your plan for more.

Bot List

Each bot appears as a card showing its name, status (online/stopped/errored), and quick action buttons. Click any bot to open its full detail page, or use the quick action buttons to Start, Stop, or Edit directly from the dashboard.

Current Plan

The dashboard also displays your current subscription tier and its limits, so you always know what you have access to.

When you click on a bot from the dashboard, you'll open its detail page with several tabs:

Starting, Stopping & Restarting

Use the buttons at the top of the bot detail page to control your bot:

• Start — brings the bot online in Discord
• Stop — takes the bot offline
• Restart — stops and starts the bot (useful after configuration changes)

Real-Time Performance Monitoring

The Overview tab shows live graphs of your bot's CPU usage and memory consumption. You can also see the bot's uptime and restart count.

Console Log Viewer

The Logs tab provides a real-time console that streams your bot's output. Logs refresh automatically every 5 seconds. This is extremely helpful for debugging issues — you'll see command usage, errors, and system messages. Log retention depends on your plan tier:

• Free — 1 day
• Pro — 30 days
• Developer (legacy) — 90 days

Regenerating Bot Code

If we've released updates to a module or if you want to apply new settings, click the "Regenerate" button. This rebuilds your bot's code with the latest templates while preserving your configuration and data. You should regenerate after:

• Enabling or disabling modules
• Platform updates that improve module features
• After toggling custom modules on or off

Bot Invite Link

From the bot detail page, you can generate a fresh Discord invite link to add your bot to additional servers.

Changing the Bot Prefix

You can change the global prefix in the Settings tab. Additionally, server administrators can change the prefix per-server using the changeprefix command directly in Discord (e.g., !changeprefix $).

Database Viewer

The Database tab provides a visual interface to browse your bot's data. You can view all tables (polls, reminders, economy balances, XP data, etc.), see row counts, and inspect individual records. Each bot has its own completely isolated database, so your data is always private.

Modules are the features that power your Discord bot. Each module adds a set of commands and functionality. You can enable or disable modules from your bot's detail page — toggle them on or off, and the bot will automatically include or exclude that feature.

Modules are organized into four tiers:

• Free — available to all users
• Pro ($9.99/mo) — unlocks every module and the AI Module Builder

The AI Module Builder lets Pro users (and free-trial test drivers) create completely custom Discord bot modules by describing what they want in plain English. The AI understands Discord.js, bot architecture, database operations, and more.

How It Works

1. Go to Module Builder in the sidebar
2. Open the Create tab
3. Describe what you want your module to do
4. The AI may ask clarifying questions to understand your needs
5. The AI generates a fully functional module with commands
6. Preview the module, then save it to your library
7. Switch to the My Modules tab to manage, share, or list on the marketplace
8. Enable it on any of your bots

Module Builder Tabs

Create — The main AI chat interface. Describe what you want and the AI generates a fully functional module. Credit cost depends on module complexity (typically 5-26 credits, approximately 1 credit per 5,000 tokens). You can upload reference images and have multi-turn conversations to iterate on your module.

My Modules — View all modules you've created. Activate or deactivate them on your bots, view version history, share with other users, or list them on the marketplace.

Credit System

Pro users receive 50 credits per month (enough to build 3–4 custom modules) that reset each billing cycle. Anyone (including Free users) can purchase credit packs that never expire — packs are one-time top-ups for the AI Module Builder, paid with PayPal (funded by your PayPal balance, linked bank account, or a card):

Smart deduction: monthly credits are always consumed first, then purchased credits. This maximizes the value of your purchased packs.

Managing Your Modules

The "My Modules" tab in the Module Builder shows all your saved modules. From here you can:

• View module details (name, description, commands)
• Make Live — activate a module so it can be enabled on bots
• View the generated code (read-only)
• Enable/disable modules on specific bots

Enabling Modules on Bots

Once a module is "live", go to your bot's detail page and scroll to the Custom Modules section. Toggle your custom modules on or off. The bot will automatically regenerate when you toggle a custom module.

Module Sharing

You can share your custom modules with other users on the platform. Here's how it works:

1. From your module card, click "Share" and enter the recipient's username
2. A share request is created and sent for approval
3. Once approved, the recipient can see and enable your module on their bots
4. This uses a reference model — shared users always get the latest version of your module automatically
5. You can revoke access at any time from the module card, which will disable it on the recipient's bots

Each module card shows who it's currently shared with, and provides inline revoke buttons.

Image Upload

You can upload up to 5 screenshots per conversation to show the AI what you want. This is useful for showing mockups, error messages, or examples of other bots. The AI can analyze the images and use them as context for generating your module.

Tips for Better Results

• Be specific — describe exactly what commands you want, what they should do, and how they should respond
• Use Plan mode first — for complex modules, brainstorm in Plan mode before building
• Mention Discord features — if you want embeds, buttons, modals, or select menus, say so
• Describe edge cases — tell the AI what should happen when things go wrong
• Iterate — use the refine feature to make adjustments

The File Manager provides 20 GB of cloud storage for Developer tier users. Files generated by AI tools are automatically saved here for download and management.

Features

• Storage quota bar — visual progress bar showing usage out of 20 GB
• Category filters — filter files by game type or category
• File details — name, size, category, date, and description for each file
• Download — download any file to your computer (rate limited: 100 downloads/hour)
• Delete — permanently remove files to free up storage

How Files Get Here

Files are created by AI tools on the platform. When the AI generates code, configs, or scripts, they are automatically saved to your File Manager. There is no manual file upload — the AI handles all file creation.

How you pay: subscriptions are billed through PayPal — funded by your PayPal balance, linked bank account, or a card inside PayPal's checkout. That means it works even when a prepaid or Cash App card refuses recurring charges (PayPal draws from your balance or bank instead). Note that PayPal cancellations take effect immediately. Credit packs are separate — one-time top-ups for the AI Module Builder, also paid with PayPal.

How to Upgrade

Go to the Subscription page from the sidebar and click "Subscribe with PayPal". You'll be redirected to PayPal's secure checkout, which can draw from your PayPal balance, linked bank account, or a card. Once payment is confirmed, your account is upgraded immediately.

Managing Your Subscription

Your plan is billed through PayPal. From the Subscription page you can cancel anytime (takes effect immediately). To review payments or change the funding source, open Automatic Payments in your PayPal account settings. Accounts still on a legacy card-billed plan see a "Manage Billing" button instead, which opens the billing portal (payment history, invoices, card updates, monthly/yearly switch).

Canceling & Reactivating

You can cancel your subscription at any time. Cancellation takes effect immediately — your plan ends right away rather than at the end of the billing period, and you can subscribe again whenever you like. Legacy card-billed plans (no longer sold) instead stay active until the end of the current billing period as they wind down, and can be reactivated before the period ends.

Promotion Codes

If you have a promotion code, redeem it on the Redeem page (builddiscordbots.com/redeem) — codes apply their reward directly to your account.

Earn 25% lifetime commission on every purchase made by users you refer to the platform. This includes subscriptions, subscription renewals, and credit pack purchases — forever.

How It Works

1. Go to the Referrals page from the sidebar
2. Copy your unique referral link (e.g., builddiscordbots.com/register?ref=YOURCODE)
3. Share the link with friends, communities, or social media
4. When someone signs up using your link and makes a purchase, you earn 25% commission
5. Once your earnings reach $50, you can request a payout

Your Referral Code

Every user gets an auto-generated 8-character referral code. You can also customize your code (3–20 characters, alphanumeric) by clicking the edit button on the Referrals page.

Benefits for Referred Users

Users who sign up with your referral link get 10% off their first purchase. This discount is applied automatically at checkout.

Referral Dashboard

The Referrals page shows everything you need:

• Stats cards — total referrals, total earned, available for payout, paid out
• Referred Users tab — see who you've referred with their join date and subscription tier
• Earnings tab — per-transaction breakdown showing purchase type, amount, and your commission
• Payouts tab — track your payout requests and their status

Requesting a Payout

Once your available earnings reach $50.00, a "Request Payout" button becomes available. Payouts are processed by our team and can be sent via Stripe or bank transfer. Below the threshold, you'll see a progress indicator showing how close you are.

The Module Marketplace is where the community shares and sells custom bot modules. Browse modules created by other users, purchase them with real USD via Stripe, or list your own creations for sale. Modules can be listed for free ($0) or priced between $0.99 and $50.00.

Browsing the Marketplace

Navigate to Marketplace in the sidebar to explore available modules. Each module card shows:

• Screenshot preview — a thumbnail image of the module in action (or a styled placeholder)
• Price badge — the USD price overlaid on the card
• Category — the module's category (Moderation, Economy, Fun & Games, Social, Utility, etc.)
• Ratings & downloads — community ratings and download count
• Seller name — who created the module

Use the category filter, search bar, and sort options (Newest, Most Popular, Top Rated, Price) to find what you're looking for.

Buying a Module

Module Detail View

Clicking a module opens a detail modal with:

• Screenshot gallery — browse up to 5 screenshots with arrow navigation and clickable thumbnails
• Full description — the seller's detailed description of the module (supports markdown)
• Commands list — all commands the module adds to your bot
• Stats sidebar — rating, download count, number of commands, version number
• Reviews — read and write reviews with star ratings

Selling Modules (Pro & Developer)

Pro and Developer users can list their custom modules on the marketplace to earn real money. Here's how:

Revenue & Payouts

When someone purchases your module:

• 70/30 revenue split — you keep 70% of every sale, the platform takes 30%
• Earnings tracked automatically — view your balance on the Seller Earnings page
• Payout at $50+ — once your available balance reaches $50, click "Request Payout"
• Payout methods — Stripe or bank transfer (set up your payout profile first)

Seller Earnings Dashboard

Access your earnings from Seller Earnings in the sidebar (Pro and Developer). The dashboard shows:

• Available Balance — what you can request as a payout
• Total Earned — lifetime earnings across all sales
• Paid Out — total amount already paid to you
• Total Sales — number of modules sold
• Per-sale breakdown — each transaction with gross, platform fee, and your net amount
• Payout history — track all payout requests and their status

Bot Templates let you create a new bot with pre-selected modules and settings tailored for specific use cases. Instead of manually enabling and configuring each module, pick a template and get a ready-to-go bot in seconds.

How to Use Templates

Templates are a great starting point — you can always customize the bot further by enabling/disabling additional modules and adjusting settings after deployment.

Most modules have settings you can configure from the dashboard. Here's how the configuration system works:

Accessing Module Settings

Go to your bot's detail page and click on the Modules tab. Click any enabled module to open its configuration panel.

Server Selector

If your bot is in multiple Discord servers, you'll see a server selector dropdown at the top of the configuration panel. This lets you configure the module differently for each server. For example, you might have different welcome messages for different communities.

Auto-Save

All configuration changes are saved automatically — there's no "Save" button to click. As soon as you change a setting, it's applied to your bot's database.

Channel Creation

Some modules (like Welcome & Goodbye) offer one-click channel creation directly from the dashboard. If you haven't set up the required channels yet, the UI will offer to create them for you.

How Settings Work

Settings are stored per-bot, per-server in each bot's isolated database. This means:

• Each bot has its own independent settings
• Each Discord server your bot is in can have different settings
• Settings persist through bot restarts
• Regenerating your bot does not reset your settings

The platform includes an interactive tutorial system with guided tours that walk you through key features step-by-step. Tours highlight specific buttons, fields, and sections on the page so you always know where to click next.

Getting Started Page

Visit the Getting Started page from the sidebar to see your tutorial hub. It shows:

• Progress bar — tracks how many of the 3 tutorials you've completed
• Tour cards — each tour with its status (Not Started / In Progress / Completed) and a preview of steps
• Discord bot setup guide — how to create a bot in the Discord Developer Portal, enable intents, and get your Client ID

Available Tours

Welcome Modal

When you first sign up and haven't created any bots yet, a Welcome Modal appears with three options:

• Start Tour — launches the "Create Your First Bot" guided tour immediately
• Go to Tutorial Hub — takes you to the Getting Started page to explore at your own pace
• Skip — dismiss the modal and explore on your own

Help Button

A floating Help button is available in the bottom-right corner of every page. Click it to see:

• Available tours for the current page
• Quick links to Getting Started, Documentation, and Support

Promo codes let you try premium features for free. A promo code can grant a temporary tier upgrade (e.g., Pro for 14 days), free AI credits, or both.

How to Redeem a Promo Code

There are two ways to redeem a promo code:

1. During Registration

When signing up, enter your promo code in the Promo Code field on the registration page. The code is validated instantly and shows what it grants before you sign up.

2. Using the Redeem Page

If you already have an account, go to /redeem or use a direct redeem link like /redeem/YOURCODE. If you're logged in, the code is applied immediately. If not, you'll be prompted to log in first.

What Promo Codes Can Grant

Bot sharing lets you invite other users to help manage your bots. You stay the owner, and you control exactly what each collaborator can do.

How to Share a Bot

1. Go to your bot's detail page
2. Open the Settings tab
3. Use the sharing section to add a collaborator by their user ID
4. Choose what permissions to grant

Permission Levels

How It Works

• Shared bots appear in the collaborator's bot list alongside their own bots
• Permissions are enforced on every action — collaborators can only do what you've allowed
• Only the bot owner can manage sharing (add/remove collaborators)
• You can revoke access at any time

Support Tickets

The fastest way to get help is through our support ticket system. Go to the Support page in the sidebar and create a new ticket. A 4-step wizard guides you through:

1. Choose a category — Technical Issue, Billing, Feature Request, Bug Report, or Other
2. Set priority — Low, Normal, High, or Urgent
3. Describe the issue — add a subject, detailed description, and optionally attach a screenshot
4. Review & submit

Your tickets auto-refresh every 30 seconds so you'll see staff replies in real time.

Bug Reports

Found a bug? There's a floating bug report button available on every page. Click it to open a quick bug report form that automatically captures your current page, browser info, and lets you attach screenshots. Bug reports go directly to the development team.

Discord Community

Join our Discord community for help, updates, feature discussions, and more:

Join our Discord Server