Overview
Permissions are complicated. Very complicated. And messing them up can cause stuff
to go very wrong. This page goes over all the permissions that Quark requires for
each of its features. This allows you to only grant the permissions Quark needs
for the features that your server is using.
Granting Quark the Administrator permission will prevent any issues caused
by permissions, and allow new features to work automatically.
This page is about the permissions that
Quark requires in order to function.
For information on the permissions that a user is required to have in order to run commands,
see the
commands page.
Quark’s default invite permissions are set to the minimum required for it to function +
ADMINISTRATOR. For a simple setup, you can just deselect the ADMINISTRATOR permission
and Quark will still function correctly.
Commands
Minimum Permissions
Required
We assume that Quark has been granted the slash commands scope when being invited to your server.
Optional
Slash Commands
| Command | Permissions Required |
|---|
| help | n/a |
| serverlog | n/a |
| commands | n/a |
| invite | n/a |
| privacy | n/a |
| ban | BAN_MEMBERS |
| unban | BAN_MEMBERS |
| kick | KICK_MEMBERS |
| mute | MODERATE_MEMBERS |
| unmute | MODERATE_MEMBERS |
| ping | n/a |
| purge | READ_MESSAGE_HISTORY, MANAGE_MESSAGES, VIEW_CHANNEL, CONNECT (if run in a voice channel only) |
| tags | n/a |
| language | n/a |
| reason | READ_MESSAGE_HISTORY, VIEW_CHANNEL |
| export | SEND_MESSAGES, READ_MESSAGE_HISTORY, VIEW_CHANNEL |
| debug | n/a |
| config | n/a |
Interactions
| Interaction | Permissions Required | Type |
|---|
| statusChannelToggle | MANAGE_WEBHOOKS | Button |
| showEdits | n/a | Button |
| ban | BAN_MEMBERS | Button |
| customize | n/a | Button |
| reason | READ_MESSAGE_HISTORY, VIEW_CHANNEL | Button, Modal |
Logs
Minimum Permissions
All the permissions on this page also assume that Quark has the following basic set of
permissions where appropriate.
Required
| Permission | Note |
|---|
VIEW_CHANNEL | Required for channels Quark should log (e.g. message events, voice events, channel events) |
SEND_MESSAGES | Required for Quark to send messages in the channels it logs to |
EMBED_LINKS | Required for Quark to send embeds in the channels it logs to |
SEND_MESSAGES_IN_THREADS | Required for Quark to send messages in the channels it logs to |
These permissions only need to be granted in the channels where Quark should be
able to access. It is perfectly fine to remove the VIEW_CHANNEL for private channels
which you do not want Quark to log, for example.
Optional
Although the below permissions may be marked as not required, this means the log
will still be sent even if Quark does not have the permission. However, the log may be
missing some information or may not be as detailed as it could be.
If Quark is not able to determine who carried out an action, the ignore options
for users will not work.
Member Events
Member Join
| Permission | Note | Required |
|---|
MANAGE_GUILD | Required to detect which invite was used to join the server | No |
Member Leave
No additional permissions required.
Bot Added
| Permission | Note | Required |
|---|
VIEW_AUDIT_LOG | Required to detect who added the bot to the server | No |
Bot Removed
| Permission | Note | Required |
|---|
VIEW_AUDIT_LOG | Required to detect who removed the bot from the server | No |
Nickname Update
| Permission | Note | Required |
|---|
VIEW_AUDIT_LOG | Required to receive the event from Discord | Yes |
Role Given
| Permission | Note | Required |
|---|
VIEW_AUDIT_LOG | Required to receive the event from Discord | Yes |
Role Taken
| Permission | Note | Required |
|---|
VIEW_AUDIT_LOG | Required to receive the event from Discord | Yes |
Members Pruned
| Permission | Note | Required |
|---|
VIEW_AUDIT_LOG | Required to receive the event from Discord | Yes |
Server Avatar Changed
No additional permissions required.
Message Events
Delete Attachment
| Permission | Note | Required |
|---|
VIEW_AUDIT_LOG | Required to detect who deleted the attachment | No |
READ_MESSAGE_HISTORY | Required to determine the context of a message | No |
CONNECT | Required to determine the context of a message sent in a voice channel | No |
Delete Multiple Messages
| Permission | Note | Required |
|---|
VIEW_AUDIT_LOG | Required to detect who initiated the deletion of multiple messages | No |
Delete Thread Message
| Permission | Note | Required |
|---|
VIEW_AUDIT_LOG | Required to detect who deleted the attachment | No |
READ_MESSAGE_HISTORY | Required to determine the context of a message | No |
CONNECT | Required to determine the context of a message sent in a voice channel | No |
Delete Single Message
| Permission | Note | Required |
|---|
VIEW_AUDIT_LOG | Required to detect who deleted the attachment | No |
READ_MESSAGE_HISTORY | Required to determine the context of a message | No |
CONNECT | Required to determine the context of a message sent in a voice channel | No |
Edit Thread Message
No additional permissions required.
Edit Message
No additional permissions required.
Thread Create
No additional permissions required.
Thread Delete
| Permission | Note | Required |
|---|
VIEW_AUDIT_LOG | Required to detect who deleted the thread | No |
Message Pinned
| Permission | Note | Required |
|---|
VIEW_AUDIT_LOG | Required to detect who pinned the message | Yes |
READ_MESSAGE_HISTORY | Required to get information about the message that was pinned | Yes |
Message Unpinned
| Permission | Note | Required |
|---|
VIEW_AUDIT_LOG | Required to detect who unpinned the message | No |
Reaction Removed
| Permission | Note | Required |
|---|
READ_MESSAGE_HISTORY | Required to get information about the message | Yes |
CONNECT | Required to get information about the message sent in a voice channel | Yes |
Voice Events
Stream Start
No additional permissions required.
Stream End
No additional permissions required.
Video Start
No additional permissions required.
Video Stop
No additional permissions required.
Moved
| Permission | Note | Required |
|---|
VIEW_AUDIT_LOG | Required to determine whether a user was moved by someone else or not | Yes |
Voice Channel Change
| Permission | Note | Required |
|---|
VIEW_AUDIT_LOG | Required to determine whether a user was moved by someone else or not | Yes (technically not required although all Moved logs will be confused with these logs) |
Voice Channel Join
No additional permissions required.
Voice Channel Leave
| Permission | Note | Required |
|---|
VIEW_AUDIT_LOG | Required to determine whether a user was disconnected by someone else or not | Yes (technically not required although all Disconnected logs will be confused with these logs) |
Disconnected
| Permission | Note | Required |
|---|
VIEW_AUDIT_LOG | Required to determine whether a user was disconnected by someone else or not | Yes |
Server Deafen
| Permission | Note | Required |
|---|
VIEW_AUDIT_LOG | Required to determine who deafened a user | No |
Server Mute
| Permission | Note | Required |
|---|
VIEW_AUDIT_LOG | Required to determine who muted a user | No |
Server Undeafen
| Permission | Note | Required |
|---|
VIEW_AUDIT_LOG | Required to determine who undeafened a user | No |
Server Unmute
| Permission | Note | Required |
|---|
VIEW_AUDIT_LOG | Required to determine who unmuted a user | No |
Voice Channel Status Change
| Permission | Note | Required |
|---|
VIEW_AUDIT_LOG | Required to receive the event from Discord | Yes |
Actions
Invite Create
No additional permissions required.
Invite Delete
| Permission | Note | Required |
|---|
VIEW_AUDIT_LOG | Required to determine who deleted the invite | No |
MANAGE_EMOJIS | Required to receive the event from Discord | Yes |
Emoji Create
| Permission | Note | Required |
|---|
VIEW_AUDIT_LOG | Required to determine who created the emoji | Yes |
MANAGE_EMOJIS | Required to receive the event from Discord | Yes |
Emoji Delete
| Permission | Note | Required |
|---|
VIEW_AUDIT_LOG | Required to determine who deleted the emoji | Yes |
MANAGE_EMOJIS | Required to receive the event from Discord | Yes |
Emoji Update
| Permission | Note | Required |
|---|
VIEW_AUDIT_LOG | Required to determine who updated the emoji | Yes |
MANAGE_EMOJIS | Required to receive the event from Discord | Yes |
Channels
Channel Create
| Permission | Note | Required |
|---|
VIEW_AUDIT_LOG | Required to determine who created the channel | Yes |
MANAGE_CHANNELS | Required to receive the event from Discord | Yes |
Channel Delete
| Permission | Note | Required |
|---|
VIEW_AUDIT_LOG | Required to determine who deleted the channel | Yes |
MANAGE_CHANNELS | Required to receieve the event from Discord | Yes |
Channel Update
| Permission | Note | Required |
|---|
VIEW_AUDIT_LOG | Required to determine who updated the channel | Yes |
MANAGE_CHANNELS | Required to receieve the event from Discord | Yes |
Channel Permissions Added
| Permission | Note | Required |
|---|
VIEW_AUDIT_LOG | Required to receive the event from Discord | Yes |
Channel Permissions Deleted
| Permission | Note | Required |
|---|
VIEW_AUDIT_LOG | Required to receive the event from Discord | Yes |
Channel Permissions Updated
| Permission | Note | Required |
|---|
VIEW_AUDIT_LOG | Required to receive the event from Discord | Yes |
Server
Server Modified
| Permission | Note | Required |
|---|
VIEW_AUDIT_LOG | Required to receive the event from Discord | Yes |
Server Icon Update
| Permission | Note | Required |
|---|
VIEW_AUDIT_LOG | Required to receive the event from Discord | Yes |
Server Boosted
No additional permissions required.
Server Boost Removed
No additional permissions required.
Roles
Role Create
| Permission | Note | Required |
|---|
VIEW_AUDIT_LOG | Required to view the audit log for the event | Yes |
MANAGE_ROLES | Required to manage roles and receive the event from Discord | Yes |
Role Delete
| Permission | Note | Required |
|---|
VIEW_AUDIT_LOG | Required to determine who deleted the role | Yes |
MANAGE_ROLES | Required to manage roles and receive the event from Discord | Yes |
Role Update
| Permission | Note | Required |
|---|
VIEW_AUDIT_LOG | Required to view the audit log for the role update event | Yes |
MANAGE_ROLES | Required to manage roles and receive the event from Discord | Yes |
Role Permissions Updated
| Permission | Note | Required |
|---|
VIEW_AUDIT_LOG | Required to receive the event from Discord | Yes |
Role Icon Update
| Permission | Note | Required |
|---|
VIEW_AUDIT_LOG | Required to receive the event from Discord | Yes |
Modlogs
Ban
| Permission | Note | Required |
|---|
VIEW_AUDIT_LOG | Required to receive the event from Discord | Yes |
Timeout
| Permission | Note | Required |
|---|
VIEW_AUDIT_LOG | Required to receive the event from Discord | Yes |
Kick
| Permission | Note | Required |
|---|
VIEW_AUDIT_LOG | Required to receive the event from Discord | Yes |
Timeout Removed
| Permission | Note | Required |
|---|
VIEW_AUDIT_LOG | Required to receive the event from Discord | Yes |
Unban
| Permission | Note | Required |
|---|
VIEW_AUDIT_LOG | Required to receive the event from Discord | Yes |
MANAGE_EMOJIS | Required to manage emojis and receive the event from Discord | Yes |
