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
Check your VibeCord dashboard
- Go to app.vibecord.dev
- Find your bot
- Is it showing “Online”, “Offline”, or “Error”?
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
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”
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
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
1) Confirm the bot is online
Check your dashboard. The bot should show “Online” status.
2) Confirm you’re using / commands
Commands start with /. Type / in Discord to see available commands.
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
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
Test in another channel to see if it’s a channel-specific issue.
Commands are missing
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
Sometimes commands are named slightly differently. Check the full list.
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
This is usually a role hierarchy issue.
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
Discord prevents bots from assigning roles that are at or above their own role. It’s a security feature.
Verify Role Exists
Make sure the role you’re trying to assign actually exists in the server.
Welcome messages aren’t working
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
Make sure your welcome message is configured for a channel that exists.
3. Test with a friend
Have someone join your server to test. You can’t trigger join events yourself.
4. Check your description
Review your bot description. Is the welcome message clearly defined?
Can’t Sign In
”Access Denied” from Discord
- Make sure you clicked Authorize, not Cancel
- Try signing in again
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”
- Try again in a few minutes
- Check if Discord is having issues at status.discord.com
Bot Was Working, Now It’s Not
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
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
Look at your bot’s activity log in the dashboard for error messages.
Slow Response Time
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
During peak times, responses might be slightly slower.
Complex commands
Commands that do many things take longer. Consider simplifying if speed is critical.
Can’t Delete or Edit Bot
Bot is currently running
Tell VibeCord to stop the bot first (“Stop the bot”), then try editing or deleting.
Page not loading
Try refreshing. If the issue persists, try a different browser.
Account issues
Make sure you’re signed into the correct account that owns the bot.
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.