Overview
Sync groups let you keep emotes consistent across multiple servers. Choose a source — either a collection or a server — and Kao syncs those emotes to all your target servers.
Sync Modes
Collection Source
Sync a collection's emotes to one or more servers:
- The collection is the single source of truth
- Add or remove emotes from the collection, then sync to push changes
- Great for maintaining a curated set across multiple communities
Server Mirror
Mirror one server's emojis to other servers:
- Pick a source server and one or more target servers
- Target servers match the source server's emojis
- Useful for keeping brand/community servers in sync
Creating a Sync Group
A 4-step wizard walks you through setup:
Step 1: Choose Mode
Select Collection Source or Server Mirror.
Step 2: Select Source
- For Collection Source: pick the collection to sync from
- For Server Mirror: pick the source server
Step 3: Select Targets
Choose which servers receive the synced emotes. You can select multiple target servers.
Your bot must be in all target servers with the Manage Emojis permission.
Step 4: Settings
Configure your sync group:
| Setting | Description |
|---|---|
| Name | A name for this sync group |
| Remove Extra Emojis | When enabled, deletes emojis on target servers that aren't in the source |
| Sync Animated Emotes | Include animated emotes in the sync |
| Sync Static Emotes | Include static emotes in the sync |
Enabling "Remove Extra Emojis" will delete any emojis on target servers that don't exist in the source. Use this carefully.
Running a Sync
Syncs are triggered manually:
- Go to Sync in your dashboard
- Click Execute on the sync group
- Kao compares source and targets, then adds/removes emotes as needed
- Progress streams in real time
What Happens During a Sync
- Kao fetches emotes from the source (collection or server)
- For each target server, it compares current emojis against the source
- Missing emotes are added, extra emotes are removed (if enabled)
- Per-target status is tracked: emotes added, removed, and failed
Viewing Sync Results
Per-Target Status
Each target server shows its own sync status:
- Synced - Target matches the source
- Pending - Waiting to be synced
- Syncing - Currently in progress
- Error - Something went wrong
Sync History
View past executions:
- Open the sync group
- Click History
- See results for each execution, broken down by target server
Managing Sync Groups
- Edit - Change name, settings, or targets
- Delete - Remove the sync group entirely
- Add/Remove Targets - Adjust which servers are included
Best Practices
Start Small
Test with one target server before adding many. Verify the sync produces the results you want.
Be Careful with "Remove Extra"
Only enable "Remove Extra Emojis" if you want the target servers to exactly match the source. Otherwise, targets will keep their own emojis plus the synced ones.
Collection Source vs Server Mirror
- Use Collection Source when you want to curate a specific set of emotes
- Use Server Mirror when you want servers to be exact copies of each other
Troubleshooting
Sync Failed for One Target
- Check that the bot is still in that server
- Verify the bot has Manage Emojis permission
- The target server may be at emoji capacity
Emotes Not Appearing
- The operation queue processes emotes with rate limiting — give it time
- Check the sync history for per-target error details
"Too many targets"
Your plan limits the number of target servers per sync group. Upgrade or reduce targets.