Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.stellarbot.dev/llms.txt

Use this file to discover all available pages before exploring further.

Stellar’s logging system gives you a continuous audit trail of activity in your server by posting event records to a channel of your choosing. This makes it straightforward to review what happened during an incident, track edits and deletions, and hold members accountable — even for actions that Discord itself does not surface prominently. You can exclude individual channels from being logged, which is useful for high-volume channels like bot-command channels that would otherwise flood your log feed. All /logs subcommands require the Manage Server permission.

Setup

1

Create a dedicated log channel

Create a private text channel (e.g. #server-logs) that only your moderation team can see. Keep it separate from your other mod channels so the log feed stays readable.
2

Set the log channel

Run /logs setchannel #server-logs. Stellar will automatically grant itself the necessary permissions in that channel.
3

Enable logging

Run /logs toggle to turn logging on. Stellar will confirm and remind you of the channel-ignore commands.
4

Exclude noisy channels (optional)

If certain channels generate too much log activity, run /logs ignorechannel #channel to stop logging events from them.
5

Verify your config

Run /logs config to confirm the log channel and see all currently ignored channels.
You must set a log channel with /logs setchannel before you can toggle logging on. Attempting to use /logs toggle without a channel set will return an error.

Commands

/logs setchannel

Set the channel where Stellar will post server event logs. Stellar will automatically add a permission overwrite giving itself full access to that channel. The channel must be a text channel.
ParameterRequiredDescription
channelYesThe text channel to use for logs.
Stellar needs Access Channel and Manage Permissions in the target channel to grant itself access. If Stellar cannot apply the overwrite, it will return an error and you will need to grant access manually.
/logs setchannel #server-logs

/logs toggle

Enable or disable the logging system. Running the command again reverses the current state. Logging cannot be turned on unless a log channel has been set first.
/logs toggle

/logs config

Display the current logging configuration, including whether logging is enabled, the configured log channel, and all channels that are currently being ignored.
/logs config

/logs ignorechannel

Exclude a text channel from being logged. Events originating from that channel (such as message edits or deletions) will no longer appear in the log feed. Logging must be enabled before you can add channels to the ignore list.
ParameterRequiredDescription
channelYesThe text channel to stop logging.
Ignore high-traffic bot-command channels (e.g. #bots) to keep your log channel focused on meaningful moderation events.
/logs ignorechannel #bots

/logs unignorechannel

Re-include a previously ignored text channel so its events are logged again. Logging must be enabled, and the channel must already be in the ignore list.
ParameterRequiredDescription
channelYesThe text channel to resume logging.
/logs unignorechannel #bots
Last modified on May 6, 2026