Troubleshooting

Bot Issues

Bot token is invalid

Symptoms:

• Error message: "Invalid bot token"
• Cannot connect bot to Kao

Solutions:

1. Go to Discord Developer Portal
2. Select your application
3. Go to Bot section
4. Click Reset Token to generate a new token
5. Copy the new token and paste it into Kao

Bot not responding to commands

Symptoms:

• Bot appears online but ignores commands
• No errors shown

Solutions:

1. Verify the command prefix is correct
2. Check bot has permission to read messages in the channel
3. Try the command in a different channel
4. Check if the bot is actually online in Discord

Bot goes offline frequently

Symptoms:

• Bot disconnects and reconnects
• Status fluctuates between online/offline

Solutions:

1. Check if Discord is having issues (status.discord.com)
2. If self-hosting, verify your server's network stability
3. Contact support if the issue persists

Import Issues

"Server at emoji capacity"

Symptoms:

• Cannot import new emotes
• Error shows capacity reached

Solutions:

1. Delete unused emotes from your server
2. Check if you're importing to the correct server
3. Boost the server for more emoji slots

Capacity by boost level:

"Bot lacks permission"

Symptoms:

• Import fails with permission error
• Cannot manage emojis

Solutions:

1. Go to your Discord server settings
2. Navigate to Roles
3. Find your bot's role
4. Enable Manage Emojis and Stickers permission
5. Or re-invite the bot with correct permissions

"Emote not found"

Symptoms:

• Search finds emote but import fails
• Error says emote doesn't exist

Solutions:

1. The emote may have been deleted from the source
2. Try searching for a similar emote
3. The source platform may be temporarily down

Import is very slow

Symptoms:

• Imports take more than 10 seconds
• Progress seems stuck

Solutions:

1. Check your internet connection
2. The source platform may be slow
3. Try importing fewer emotes at once
4. Wait and retry later

Search Issues

No search results

Symptoms:

• Searching returns zero emotes
• Known emotes don't appear

Solutions:

1. Check your spelling
2. Try a shorter search term
3. Try different platforms (7TV, BTTV, FFZ)
4. Some emotes are unlisted or private

Search is slow

Symptoms:

• Results take a long time to load
• Search appears frozen

Solutions:

1. The emote platforms may be experiencing high load
2. Try a more specific search term
3. Refresh the page and try again

Authentication Issues

Can't sign in with Discord

Symptoms:

• OAuth flow fails
• Redirected back without signing in

Solutions:

1. Clear your browser cookies for usekao.com
2. Disable browser extensions temporarily
3. Try a different browser
4. Check if Discord is having issues

Session expired unexpectedly

Symptoms:

• Logged out without clicking sign out
• "Session expired" message

Solutions:

1. Sessions expire after 30 days of inactivity
2. Simply sign in again
3. If happening frequently, clear cookies and sign in fresh

"Unauthorized" errors

Symptoms:

• API calls fail with 401 error
• Dashboard features don't work

Solutions:

1. Sign out and sign in again
2. Clear browser cookies
3. Check if you're using an outdated bookmark

Server Issues

Can't see my servers

Symptoms:

• Server dropdown is empty
• Servers not appearing in list

Solutions:

1. Make sure you have Manage Server or Administrator permission
2. Sign out and sign in again to refresh server list
3. The bot needs to be in the server to manage it

Wrong server selected

Symptoms:

• Emotes going to wrong server
• Managing wrong server's emojis

Solutions:

1. Double-check the server selector dropdown
2. Servers with similar names can be confusing
3. Verify server icon matches expected server

Dashboard Issues

Page won't load

Symptoms:

• White screen or loading forever
• Error message displayed

Solutions:

1. Hard refresh the page (Ctrl+Shift+R / Cmd+Shift+R)
2. Clear browser cache
3. Try incognito/private mode
4. Check your internet connection

Features not working

Symptoms:

• Buttons don't respond
• Actions don't complete

Solutions:

1. Check browser console for errors (F12)
2. Disable ad blockers temporarily
3. Try a different browser
4. Clear local storage and cookies

Getting More Help

If you've tried these solutions and still have issues:

When asking for help, please include:

• What you were trying to do
• The exact error message
• Steps you've already tried
• Browser and OS you're using