Skip to main content
When something happens in your server, Quark builds a log and posts it in a log channel. This page covers what is in a log and how it gets to the right channel. For the full list of what can be logged, see types.

What is in a log

A standard log is an embed with the parts below. A log format can change which of them are shown and how the log is laid out.
  • The member it is about, with their avatar, at the top.
  • A title with an icon, such as “Message Deleted” or “User Joined”.
  • The details: the message content, the channel, the moderator, the reason, and so on, depending on the log type.
  • The time it happened: when Discord told Quark about it, not when the log was posted. A log that waited for the audit log, or was sent again after a delay, still shows when it happened. Logs about changes to Quark’s settings, and what an automation rule did, are dated when they were made. For a deleted message, the time is when the message was sent.
  • A footer with ID: followed by an ID, usually the user ID of the member the log is about. Join and leave logs also show the server’s member count.

Buttons

Every log can carry up to three standard buttons. Choose which appear under Logging → Other → Buttons on the dashboard. Some newly added servers start with them switched off: see log buttons. A log format can reorder them, leave them off some logs, and add link buttons of your own. With Quark Pro it can also add action buttons, which moderate or send a message when pressed. Some log types have a button of their own:
The Ban button bans immediately. There is no confirmation step.
When a reason is edited, the modlog gains a line under the reason: “Edited by”, the moderator and the time. To stop reasons being edited after a set time, or at all, see modlog reasons. For who can use each button, how images on a modlog work and what History shows on each plan, see buttons on logs.

The Apps menu

Three more actions are in a log’s menu. Right-click the log, or long-press it on a phone, and choose Apps. By default, Get IDs and Show edits are shown to members with Manage Messages, and Report log issue to members with both Manage Channels and Manage Server. You can change that in Server Settings → Integrations → Quark.
  • Jump to context on a deleted message takes you to the message it was replying to, or to the message just before it in the channel.
  • Jump to message on edit and reaction logs takes you to the message itself.

Warnings

A deleted-message log flags two things: an invite link in the message, and a ghost ping, which is a mention deleted within 10 seconds of being sent. Permission logs flag dangerous permissions.

Where logs go

There are twelve destinations: one main channel, nine category channels and two special categories. Each category is in one of three states:
  • Follows the main channel. This is the default.
  • Has its own channel.
  • Switched off. Nothing in that category is logged.
The two special categories are not categories of log types. Each takes certain message logs out of Messages. With no channel of its own, a special category goes wherever Messages goes, and it cannot be switched off. Quark picks the channel for a log in this order:
  1. The Age-restricted channel, if you set one and the log is one it takes. See age-restricted channels.
  2. The log type’s own channel, if you set one. This needs Quark Pro or Pro Lite. See customization.
  3. Its category’s channel.
  4. The main channel.
Setting the main channel, setting category and special category channels and switching categories off are free on every plan.

Files

Files only carries deleted attachments. If you set a Files channel, the attachments of each deleted message are posted there together as an “Attachment Deleted” log. If you do not, the files are attached to the Message Deleted log, wherever your Messages logs go. Files can be given a channel on the dashboard, but it cannot be switched off.

Age-restricted channels

A deleted or edited message is logged with what it said and its files. Set an Age-restricted channel to keep that content from your age-restricted channels out of your other log channels.
  • It comes before a log type’s own channel and before the Files channel. Deleted files from an age-restricted channel go to the Age-restricted channel.
  • It does not switch anything back on. If Messages, or one of these log types, is switched off, those logs stay off.
  • If the channel you chose later stops being age-restricted in Discord, the logs keep going there and the dashboard says so on the row.
  • It can only be set on the dashboard or through the API, not with /logging.

Set your channels

Go to Logging → Channels. Set the main logging channel at the top. Each category below it has a switch and a channel dropdown. Files and Age-restricted are in the Special categories section under the categories.
Log channels can be text channels, announcement channels or threads. After you choose a channel, Quark posts a confirmation in it. If you do not see one, see troubleshooting.