What's Logging?

Logging enables Circle to report most events in your server, such as message deletions, to a designated channel (or multiple) to always stay on top of what's going on. You can even log deleted images, videos, and other files. Amazing, right?

Getting Started

1. Navigate to your server's dashboard.
2. Select the Logging plugin. If it's not enabled, you'll need to enable it.
3. Follow the instructions below.

Logging Modes: Embeds vs. Compact

Circle has two logging modes: embeds and compact.

1. To set the logging mode, simply click the drop-down and choose either Embeds or Compact Messages.
2. Scroll down and press "Save".

What's Embed Logging?

Embed logging is the industry standard logging. It's modern, cozy and color coded so you can identify different events with ease. With Circle Premium, you can even change which color each event is logged with (read more here).

What's Compact Logging?

Compact logging is embedless, straight-to-the-point logging. It's small so you can see more events in the same screen-space. Similar to how embed logging is color coded, compact logging uses different emojis for each logging event, so you can easily spot different events. With Circle Premium, you can even change which emoji each event is logged with (read more here).

Logging Channels

Circle can either log all events to one channel, or delegate different events to different channels.

Sending All Events to One Channel

1. Select a "Logging Channel" from the drop-down.
2. Scroll down and press "Save".

Separating Events to Different Logging Channels

1. Tick the "Separate each logging event into a different channel" option.
2. Select a channel for each event. Leaving a box empty will disable the event and selecting Use Default Channel will use the channel selected in the "Logging Channel" box.
3. Scroll down and press "Save", once you've chosen all of your channels for each event.

Ignoring Channels, Categories & Roles

1. To ignore a channel/category/role, simply select it from the relevant drop-down.
2. Scroll down and press "Save".

[PREMIUM] Setting Custom Embed Colors/Emojis

Premium users are able to set up a custom embed color (for embed logging users) or a custom emoji (for compact logging users) for each individual logging event. To set this up, follow these steps:

1. Click the gear icon to the left of the logging event you wish to edit.
2. If you're using embed logging, open the "Embed Color Choice" drop-down and choose whether you want to specify a specific color for your logging embed, or whether you want Circle to pick a random color for you each time Circle sends a log of that event.
3. If you want to pick a specific color, choose that from the dropdown. You'll now see a "Color" box appear. Just click that and a color picker will pop up, and you can choose whatever color you want. You can even type in your own hex code if you already have your heart set on a specific color. Once you've chosen your color, press "OK" to save your changes.
4. If you're using compact logging, just click inside of the "Emoji" box and choose what emoji you'd like to use (you can even use custom emojis from your own server). Then press "OK" to save your changes.

[PREMIUM] Private Log Channels

Private log channels allow you to give your lower-ranked moderators access to a log channel for the rest of the server, and have a separate log channel for higher-ranked moderators to allow them to view logs of more sensitive channels & categories.

For example, if your logging system allows your moderators to view logs of every channel in the server except for your private administrator channels, normally you'd have to just ignore those admin channels so that your moderators can't see any deleted/edited message logs from your admin channels in the log channel. But with private channel logging, you can have a separate logging channel which only your admins can see, which Circle will use to send deleted/edited message logs (and much more) from your admin channels.

To set up a private log channel, follow these steps:

1. Scroll to the bottom of your logging page until you see "Private Channel Logs".
2. Click the "Create New" button.
3. On the popup dialogue that appears, click the "Logging Channel" drop-down and choose a private logging channel. This is the channel where Circle will send logs from anything that happens inside of your "Private Channels".
4. Now click the "Private Channels" drop-down and choose any private channels or categories which shouldn't get logged to your main logging channel. Then press "Save" to save your changes.
5. You will now see your private log channel appear in the list of your private log channels. You can click "Edit" to make any changes to it, or click "Delete" to delete it.

Updated on: 08/11/2025