Rotations

Overview

Rotations automatically swap your server's emojis on a schedule. Pick a collection of emotes, set a schedule, and Kao handles the rest — replacing your server's emojis with fresh ones at each interval.

Creating a Rotation

A 5-step wizard guides you through setup:

Step 1: Name & Server

1. Go to Rotations in your dashboard
2. Click Create Rotation
3. Enter a rotation name
4. Select the target server

Step 2: Collection

Choose the collection that supplies emotes for this rotation. The rotation pulls emotes from this collection each time it runs.

Step 3: Schedule

Choose how often the rotation runs:

Cron presets are available for common schedules:

• Every hour, every 6 hours, every 12 hours
• Daily at midnight or noon
• Weekly on Sunday

You can also set the timezone for your schedule.

Step 4: Behavior

Choose how the rotation handles emojis:

• Full Replacement - Removes all current emojis and replaces them with emotes from the collection

Step 5: Review

Review your settings and confirm. The rotation starts on its next scheduled interval.

Managing Rotations

Toggle On/Off

Pause a rotation without deleting it:

1. Go to Rotations
2. Click the toggle next to the rotation
3. The rotation stops running until re-enabled

Manual Trigger

Run a rotation immediately without waiting for the schedule:

1. Open the rotation
2. Click Execute Now
3. The rotation runs immediately

View History

See past executions and their results:

1. Open the rotation
2. Click History
3. Review each execution's status, emotes added/removed, and any errors

Edit or Delete

• Click a rotation to view details and edit settings
• Delete a rotation to stop it permanently

How Rotations Work

When a rotation fires:

1. Kao checks which emotes are currently on the server
2. Based on the behavior, it plans which emotes to remove and add
3. Operations are queued and processed with rate limiting (~50 per hour per server)
4. Progress streams in real time to your dashboard

Troubleshooting

Rotation Didn't Run

• Check that the rotation is enabled (toggled on)
• Verify your bot is online and in the target server
• Check the rotation history for error messages

Emotes Missing After Rotation

• Full replacement removes all existing emojis first — this is expected
• Check if the rotation completed successfully in the history
• If it partially failed, some emotes may not have been added due to rate limits

"Plan limit reached"

Your plan has a maximum number of active rotations. Upgrade your plan or delete unused rotations.

Next Steps