Kanin's BotBaseTour of the Dashboard
Every server's dashboard has the same layout: a sidebar on the left and the page you opened on the right. This page walks through both.
The sidebar
From top to bottom, the sidebar holds:
- The bot's name and avatar, linking to the dashboard's home page.
- The server switcher, showing the server you are in. Click it to jump to another server you manage, or pick All Servers to go back to the server list.
- Dashboard, Settings, Permissions and Logs: the server's activity overview, its server settings, the bot's permission check and the staff logs.
- Media: Bot Profile, Message Builder, Image Builder, Templates, Media and Forms.
- Engagement, Moderation and Utilities: the modules, each with a status dot.
- Your account, at the bottom.
Status dots
The dot next to a module tells you its state in this server:
| Dot | Meaning |
|---|---|
| Green | The module is on. |
| Grey | The module is off. Open it and use the switch at the top to turn it on. |
| Red | The module is blocked: another module it needs is off or not installed. Hover the dot to see which. |
A red or amber warning icon next to a module name means the same kind of problem: red for a module it requires, amber for an optional one it works better with. Hover the icon for the module names, and turn those modules on to clear it.
Your account menu
Click your name at the bottom of the sidebar for Home, Status, Docs, All Servers, your personal Settings and Log out. Your personal settings (theme, timezone, birthday, privacy and data) are covered in Your Account, Privacy and Data.
Module pages
Every module page has the same parts:
- The module in the sidebar, highlighted while it is open.
- The switch at the top right turns the module on or off for this server. It takes effect at once.
- Tabs split the module into areas. Most modules have a settings tab first, then Commands (turn individual slash commands on or off) and finally Logs (the staff logs for just this module). The tab you open is kept in the address, so you can bookmark or share a link to it.
- Settings on the tab you are viewing, here the XP cooldown, just changed.
- Undo puts every setting back to what was last saved.
- Save Changes saves everything you changed, on every tab of the page.
Saving changes
Changes to settings are not saved as you type. As soon as you change something, a bar appears at the bottom of the page reading Unsaved changes, with the Undo and Save Changes buttons.
You can switch tabs without losing edits. If you try to leave the page with unsaved changes, the dashboard stays put and the bar shakes: save or undo first. Closing or reloading the browser tab asks you to confirm.
If the server rejects a value (for example a vanity URL that is taken), that field shows the error and stays unsaved, while your other changes are saved.
Changes made in Discord
The dashboard follows what happens in Discord while it is open: new and renamed channels and roles show up in the pickers, and a change made with a slash command or in another tab appears without a reload. Your unsaved edits stay as they are.
When you delete a channel or role in Discord, the bot removes it from every setting:
- Settings that exist only for it are deleted: a stat channel, a sticky message, a feed subscription or a log channel on that channel, a level reward, activity role or age role for that role, and a reward track that required it.
- A setting that pointed at it is cleared, such as a welcome or announcement channel, a mute role or a leaderboard's channel. A leaderboard left with neither a channel nor a role is turned off.
- Lists and filters drop it. A filter left empty no longer filters, the same as when you empty it yourself.
- An automation rule that would otherwise act more widely (a Role added condition naming only that role, a slowmode or permission change on only that channel) is turned off, so you can pick a new one.
Every one of these changes is written to the staff logs of the module it belongs to, with the bot as the actor, the source Automatic and what was deleted, for example Disabled the rule "Raid lockdown" because @Raid Watch was deleted. So are the other changes the bot makes on its own, such as a feed subscription it turns off because its webhook was deleted or a leaderboard it pauses after five failed runs.
An editor you have open for something that was deleted closes and tells you so, and a deleted channel or role disappears from the one you are editing. Things deleted while the bot was offline are not cleaned up this way: the settings that use them fail and say so, and you can pick another channel or role.
On a phone
On a narrow screen the sidebar is hidden. Tap the menu button at the top left to open it, and tap a page to close it again.
Next steps
Work through the first-time setup checklist.