Troubleshooting
TL;DR
Start by checking whether your bot is Online/Offline/Error in the dashboard.
Most issues are permissions, role hierarchy, or Discord configuration.
Having issues? Find solutions to the most common problems here.
Last updated: 2025-12-14
Bot won’t come online
Section titled “Bot won’t come online”Check your VibeCord dashboard
Section titled “Check your VibeCord dashboard”- Go to app.vibecord.dev
- Find your bot
- Is it showing “Online”, “Offline”, or “Error”?
If it shows “Offline”
Section titled “If it shows “Offline””Tell VibeCord to start your bot: “Start the bot” or “Deploy my bot”. Wait 30-60 seconds.
If it shows “Starting” for more than 5 minutes
Section titled “If it shows “Starting” for more than 5 minutes”Try telling VibeCord to stop and restart: “Stop the bot” then “Start the bot”. If it still won’t start, contact support.
If it shows “Error”
Section titled “If it shows “Error””Click on the bot to see the error details. Common errors:
- Rate limited — Too many requests, wait 15 minutes
- Invalid configuration — Try regenerating your bot
- Server error — Our team has been notified, try again later
Check your plan limits
Section titled “Check your plan limits”Each plan has different limits on how many bots can run at once. Check your current plan to see your allowance.
If you’re at your limit, stop another bot or upgrade your plan.
Bot isn’t responding to slash commands
Section titled “Bot isn’t responding to slash commands”1) Confirm the bot is online
Section titled “1) Confirm the bot is online”Check your dashboard. The bot should show “Online” status.
2) Confirm you’re using / commands
Section titled “2) Confirm you’re using / commands”Commands start with /. Type / in Discord to see available commands.
3) Check channel permissions
Section titled “3) Check channel permissions”Your bot might not have permission to read or send messages in that channel.
Fix: Go to Server Settings → Channels → Select channel → Permissions → Add your bot → Allow “View Channel” and “Send Messages”
4) Check role hierarchy
Section titled “4) Check role hierarchy”If the command involves roles, your bot’s role needs to be higher than the roles it manages.
Fix: Server Settings → Roles → Drag your bot’s role above roles it needs to manage
5. Try a different channel
Section titled “5. Try a different channel”Test in another channel to see if it’s a channel-specific issue.
Commands are missing
Section titled “Commands are missing”Check what commands were generated
Section titled “Check what commands were generated”- Go to your bot’s page on the dashboard
- Click the Commands tab
- Compare with what you expected
Command might have a different name
Section titled “Command might have a different name”Sometimes commands are named slightly differently. Check the full list.
Add missing commands
Section titled “Add missing commands”Edit your bot and add the command to your description:
“Add a /help command that lists all available commands”
Then regenerate.
Bot can’t assign roles
Section titled “Bot can’t assign roles”This is usually a role hierarchy issue.
The Fix
Section titled “The Fix”- Go to Discord Server Settings → Roles
- Find your bot’s role
- Drag it above all roles the bot needs to assign
- Click Save
Why This Happens
Section titled “Why This Happens”Discord prevents bots from assigning roles that are at or above their own role. It’s a security feature.
Verify Role Exists
Section titled “Verify Role Exists”Make sure the role you’re trying to assign actually exists in the server.
Welcome messages aren’t working
Section titled “Welcome messages aren’t working”1. Check bot has permission
Section titled “1. Check bot has permission”Your bot needs:
- View Channel (for welcome channel)
- Send Messages
- (Optional) Manage Roles (if assigning roles)
2. Verify the channel
Section titled “2. Verify the channel”Make sure your welcome message is configured for a channel that exists.
3. Test with a friend
Section titled “3. Test with a friend”Have someone join your server to test. You can’t trigger join events yourself.
4. Check your description
Section titled “4. Check your description”Review your bot description. Is the welcome message clearly defined?
Can’t Sign In
Section titled “Can’t Sign In””Access Denied” from Discord
Section titled “”Access Denied” from Discord”- Make sure you clicked Authorize, not Cancel
- Try signing in again
Page won’t load
Section titled “Page won’t load”- Try a different browser (Chrome, Firefox, Safari, Edge)
- Clear your browser cache
- Disable browser extensions temporarily
Discord says “Something went wrong”
Section titled “Discord says “Something went wrong””- Try again in a few minutes
- Check if Discord is having issues at status.discord.com
Bot Was Working, Now It’s Not
Section titled “Bot Was Working, Now It’s Not”Something changed
Section titled “Something changed”Think about what changed recently:
- Did you edit the bot?
- Did you change server settings?
- Did you update role permissions?
Ask VibeCord to check
Section titled “Ask VibeCord to check”Sometimes asking the AI to investigate helps:
“Check if there are any errors with my bot” “What’s wrong with the deployment?”
Or create a new project if the issue persists.
Check for errors
Section titled “Check for errors”Look at your bot’s activity log in the dashboard for error messages.
Slow Response Time
Section titled “Slow Response Time”Free plan time limits
Section titled “Free plan time limits”Free plan bots run for a limited time. After the time expires, the bot goes offline.
Solution: Upgrade to a paid plan for 24/7 uptime.
High traffic
Section titled “High traffic”During peak times, responses might be slightly slower.
Complex commands
Section titled “Complex commands”Commands that do many things take longer. Consider simplifying if speed is critical.
Can’t Delete or Edit Bot
Section titled “Can’t Delete or Edit Bot”Bot is currently running
Section titled “Bot is currently running”Tell VibeCord to stop the bot first (“Stop the bot”), then try editing or deleting.
Page not loading
Section titled “Page not loading”Try refreshing. If the issue persists, try a different browser.
Account issues
Section titled “Account issues”Make sure you’re signed into the correct account that owns the bot.
Still Stuck?
Section titled “Still Stuck?”If none of these solutions work:
- Check our status page — There might be a known issue
- Gather information:
- What are you trying to do?
- What error message do you see?
- When did it last work?
- Contact support → — We’re here to help!
We typically respond within 24 hours.