Overview
Each server connected to Kao has its own settings. Control how the bot behaves, who can use it, and what notifications are sent — all on a per-server basis.
Accessing Server Settings
- Go to Servers in your dashboard
- Click on a server
- Navigate to the Settings tab
Bot Behavior
Error Verbosity
Control how much detail the bot shows when something goes wrong:
- Minimal - Short error messages
- Detailed - Full error context for debugging
Rate Limit Mode
How the bot handles Discord's rate limits:
- Automatic rate limit management ensures operations don't fail due to hitting Discord's limits too aggressively
Access Control
Control who can use the bot in your server:
| Mode | Description |
|---|---|
| Owner Only | Only the bot owner can use commands |
| Admin Only | Server admins can use commands |
| Role Based | Specific roles can use commands |
| Whitelist | Only listed users can use commands |
| Blacklist | Everyone except listed users can use commands |
Setting Up Role-Based Access
- Go to server settings
- Select Role Based access mode
- Pick which roles can use the bot
- Save changes
Notification Preferences
Discord Channel Notifications
Get notified in a Discord channel when things happen:
- Go to the Notifications tab in server settings
- Select a channel for notifications
- Enable the categories you want:
| Category | What It Notifies |
|---|---|
| Imports | When emotes are imported to the server |
| Rotations | When a rotation runs |
| Syncs | When a sync group updates the server |
| Warnings | Rate limits, permission issues, errors |
| Changelog | New Kao features and updates |
Community Announcements
Share emote events with your community via webhook:
- Go to the Community Announcements tab
- Set up a webhook for a channel
- Enable categories:
- Emote Added - When new emotes are imported
- Rotation Refreshed - When a rotation swaps emotes
- Collection Synced - When a sync updates the server
Community announcements post as rich embeds in the channel, so your members see what's happening with your emotes.
Presets
Save your server configuration as a reusable preset:
- Set up your server settings the way you want
- Go to the Presets tab
- Click Save as Preset
- Name the preset
Sharing Presets
Share your configuration with others:
- Open a preset
- Click Share to get a share code
- Others can apply your preset to their servers
Applying a Preset
- Go to the Presets tab
- Click Apply Preset
- Enter a share code or select from your saved presets
- The preset's settings are applied to the server
Applying a preset overwrites the server's current settings. Consider saving your current configuration as a preset first.
Whitelabel Branding
Customize how the bot appears in your server with whitelabel options available on higher-tier plans.
Troubleshooting
Settings Not Saving
- Make sure you click Save after making changes
- Verify you have permission to manage the server
Notifications Not Appearing
- Check that the bot has permission to send messages in the notification channel
- Verify the category is enabled
- Make sure the webhook is still valid for community announcements
Access Control Not Working
- Changes take effect immediately for new commands
- Make sure roles are correctly assigned in Discord's role settings