Commands

To get a list of available commands, do !help on your server.

Arguments & Flags

Most commands accept arguments and/or flags. According to the Type of the argument or flag you can provide different values.

Boolean

This arguments expects true or false. You can also use yes and no.

Number

This arguments expects a number

Enum

This arguments expects a value from a specific set of valid values.

Depending on the command the valid values can vary. Use !help <command> (eg. !help addRank) to get more information about the command and the valid values for the enum.

Invite Code

This arguments expects a Discord Invite Code.

You can put only the part after https://discord.gg/ to prevent Discord from creating a preview.

User

This arguments expects a Discord User. You can use any of the following methods to provide a user:

  • Mention the user: @Valandur

  • Use their ID: 102785693046026240

  • Use their name: Valandur

  • Use their name and discriminator: Valandur#3581

  • Use quotes if their name has a space: "Valandur with a space"

Role

This arguments expects a Discord Role. You can use any of the following methods to provide a role:

  • Mention the role: @Admin

  • Use the ID: 102785693046026240

  • Use the name: Admin

  • Use quotes if the name has a space: "Admin with a space"

Channel

This arguments expects a Discord Channel. You can use any of the following methods to provide a channel:

  • Mention the channel: #general

  • Use the ID: 409846838129197057

  • Use the name: general

  • Use quotes if the name has a space: "general with a space"

Command

This argument expects a command of this bot. You can use any of the following methods to provide a command:

  • Use the command name: invites

  • Use an alias of the command: p

Text

This arguments expects any text. You can use quotes ("Text with quotes") for text that has spaces.

If the text is the last argument you don't have to use quotes.

Date

This argument expects a date. You can use various formats, but we recommend: YYYY-MM-DD

Duration

This argument expects a duration. The following duration types are supported:

  • Seconds: s (5s = 5 seconds)

  • Minutes: min (3min = 3 minutes)

  • Hours: h (4h = 4 hours)

  • Days: d (2d = 2 days)

  • Weeks: w (1w = 1 week)

  • Months: mo (6mo = 6 months)

  • Years: y (10y = 10 years)

Overview

Invites

Command

Description

Usage

addInvites

Adds/Removes invites to/from a member.

!addInvites \ \ [reason]

clearInvites

Clear invites of the server/a user.

!clearInvites [-d value|--date=value][-cb|--clearbonus] [user]

createInvite

Creates unique invite codes.

!createInvite \ [channel][maxuses] [expires][temporarymembership]

info

Show info about a specific member.

!info \ [details][page]

inviteCodes

Get a list of all your invite codes

!inviteCodes

inviteDetails

Shows details about where your invites are from.

!inviteDetails [user]

invites

Show personal invites.

!invites [user]

leaderboard

Show members with most invites.

!leaderboard [page]

removeInvites

Removes a specified amount of invites from a user.

!removeInvites \ \ [reason]

restoreInvites

Restore all previously cleared invites.

!restoreInvites [user]

subtractFakes

Remove fake invites from all users.

!subtractFakes

subtractLeaves

Remove leaves from all users

!subtractLeaves

Ranks

Command

Description

Usage

addRank

Add a new rank.

!addRank \ \ [info]

fixRanks

Deletes any ranks where the role was deleted.

!fixRanks

ranks

Show all ranks.

!ranks [page]

removeRank

Remove a rank.

!removeRank \

Config

Command

Description

Usage

botConfig

Show and change the config of the bot.

!botConfig [key][value]

config

Show and change the config of the server.

!config [key][value]

interactiveConfig

Interactive Config

!interactiveConfig

inviteCodeConfig

Show and change the config of invite codes of the server.

!inviteCodeConfig [key][invitecode] [value]

memberConfig

Show and change the config of members of the server.

!memberConfig [key][user] [value]

permissions

Configure permissions to use commands.

!permissions [cmd][role]

Info

Command

Description

Usage

botInfo

Get general information about the bot.

!botInfo

credits

Show developers and contributors of the bot.

!credits

getBot

Get an invite link for the bot.

!getBot

help

Display help.

!help [command]

members

Show member count of current server.

!members

ping

Ping the bot

!ping

prefix

Shows the current prefix of the bot.

!prefix

setup

Help with setting up the bot and checking for problems (e.g. missing permissions)

!setup

support

Get an invite link to our support server.

!support

Premium

Command

Description

Usage

export

Export data of InviteLogger to a csv sheet.

!export \

premium

Info about premium version of InviteLogger.

!premium [action]

tryPremium

Try the premium version of InviteLogger for free for a limited duration.

!tryPremium

Moderation

Command

Description

Usage

ban

Ban a member from the server.

!ban [-d value|--deleteMessageDays=value] \ [reason]

caseDelete

Delete a specific case.

!caseDelete \ [reason]

caseView

View info about a specific case.

!caseView \

check

Check violation and punishment history of a user.

!check \

clean

Clean a channel of certain message types.

!clean \ [numberOfMessages]

cleanShort

Clear short messages

!cleanShort \ [numberOfMessages]

cleanText

Delete messages containing certain keywords.

!cleanText \ [numberOfMessages]

kick

Kick a member from the server.

!kick \ [reason]

lockdown

Lockdown a specific channel (Prevents anyone without special roles from sending messages)

!lockdown [-t value|--timeout=value][channel]

mute

Mute a user

!mute [-d value|--duration=value] \ [reason]

punishmentConfig

Configure punishments when reaching a certain amount of strikes.

!punishmentConfig [punishment][strikes] [args]

purge

Purge messages in a channel.

!purge \ [user]

purgeUntil

Purge messages in a channel up until a specified message.

!purgeUntil \

softBan

Ban and then automatically unban a member from the server.

!softBan [-d value|--deleteMessageDays=value] \ [reason]

strike

Add strikes to a user

!strike \ \ \

strikeConfig

Configure strikes received for various violations.

!strikeConfig [violation][strikes]

unban

Unban a user

!unban \ [reason]

unhoist

Add a character in front of all members with a special character in front of their name, so they will be shown at the end of the member list.

!unhoist

unmute

Unmute a user

!unmute \

warn

Warn a member.

!warn \ [reason]

Other

Command

Description

Usage

graph

Shows graphs about various stats on this server.

!graph \ [from][to]

!addInvites

Adds/Removes invites to/from a member.

Usage

!addInvites <user> <amount> [reason]

Aliases

  • !add-invites

Arguments

Argument

Type

Required

Description

Details

user

User

Yes

The user that will receive/lose the bonus invites.

amount

Number

Yes

The amount of invites the user will get/lose. Use a negative (-) number to remove invites.

reason

Text

No

The reason for adding/removing the invites.

Examples

!addInvites @User 5
!addInvites "Name with space" -30 Removed for cheating

!addRank

Add a new rank.

Usage

!addRank <role> <invites> [info]

Aliases

  • !add-rank

  • !set-rank

  • !setrank

Arguments

Argument

Type

Required

Description

Details

role

Role

Yes

The role which the user will receive when reaching this rank.

invites

Number

Yes

The amount of invites needed to reach the rank.

info

Text

No

A description that users will see so they know more about this rank.

Examples

!addRank @Role 5
!addRank "Role with space" 10 Wow, already 10 people!

!ban

Ban a member from the server.

Usage

!ban [-d value|--deleteMessageDays=value] <user> [reason]

Arguments

Argument

Type

Required

Description

Details

user

User

Yes

User to ban.

reason

Text

No

Why was the user banned.

Flags

Flag

Short

Type

Description

‑‑deleteMessageDays

‑d

Number

If specified will delete messages by the banned members this many days back.

Examples

!botConfig

Show and change the config of the bot.

Usage

!botConfig [key] [value]

Aliases

  • !bot-config

  • !botsetting

  • !bot-setting

Arguments

Argument

Type

Required

Description

Details

key

Enum

No

The bot config setting which you want to show/change.

Use one of the following values: activityEnabled, activityMessage, activityStatus, activityType, activityUrl, embedDefaultColor

value

Value

No

The new value of the setting.

Examples

!botConfig

!botInfo

Get general information about the bot.

Usage

!botInfo

Aliases

  • !bot-info

Examples

!botInfo

!caseDelete

Delete a specific case.

Usage

!caseDelete <caseNumber> [reason]

Aliases

  • !case-delete

  • !deletecase

  • !delete-case

Arguments

Argument

Type

Required

Description

Details

caseNumber

Number

Yes

Case number

reason

Text

No

The reason for removing the case.

Examples

!caseDelete 5434 User apologized

!caseView

View info about a specific case.

Usage

!caseView <caseNumber>

Aliases

  • !case-view

  • !viewcase

  • !view-case

Arguments

Argument

Type

Required

Description

Details

caseNumber

Number

Yes

Case number

Examples

!caseView 5434

!check

Check violation and punishment history of a user.

Usage

!check <user>

Aliases

  • !history

Arguments

Argument

Type

Required

Description

Details

user

User

Yes

User to check.

Examples

!check @User
!check "User with space"

!clean

Clean a channel of certain message types.

Usage

!clean <type> [numberOfMessages]

Aliases

  • !clear

Arguments

Argument

Type

Required

Description

Details

type

Enum

Yes

The type of messages that will be deleted.

Use one of the following values: bots, embeds, emojis, images, links, mentions, reacted, reactions

numberOfMessages

Number

No

Number of messages that will be searched.

Examples

!cleanShort

Clear short messages

Usage

!cleanShort <maxTextLength> [numberOfMessages]

Aliases

  • !clean-short

  • !clearshort

  • !clear-short

Arguments

Argument

Type

Required

Description

Details

maxTextLength

Number

Yes

All messages shorter than this will be deleted.

numberOfMessages

Number

No

Number of messages that will be searched.

Examples

!cleanText

Delete messages containing certain keywords.

Usage

!cleanText <text> [numberOfMessages]

Aliases

  • !clean-text

  • !cleartext

  • !clear-text

Arguments

Argument

Type

Required

Description

Details

text

Text

Yes

All messages containing this word will be deleted.

numberOfMessages

Number

No

Number of messages that will be searched.

Examples

!clearInvites

Clear invites of the server/a user.

Usage

!clearInvites [-d value|--date=value] [-cb|--clearBonus] [user]

Aliases

  • !clear-invites

Arguments

Argument

Type

Required

Description

Details

user

User

No

The user to clear all invites from. If omitted clears all users.

Flags

Flag

Short

Type

Description

‑‑date

‑d

Date

The date start at which invites should be counted. Default is today.

‑‑clearBonus

‑cb

Boolean

Add this flag to clear bonus invites aswell. Otherwise bonus invites are left untouched.

Examples

!clearInvites
!clearInvites @User
!clearInvites -cb "User with space"

!config

Show and change the config of the server.

Usage

!config [key] [value]

Aliases

  • !c

Arguments

Argument

Type

Required

Description

Details

key

Enum

No

The config setting which you want to show/change.

Use one of the following values: autoModAllCapsEnabled, autoModAllCapsMinCharacters, autoModAllCapsPercentageCaps, autoModDeleteBotMessage, autoModDeleteBotMessageTimeoutInSeconds, autoModDisabledForOldMembers, autoModDisabledForOldMembersThreshold, autoModDuplicateTextEnabled, autoModDuplicateTextTimeframeInSeconds, autoModEmojisEnabled, autoModEmojisMaxNumberOfEmojis, autoModEnabled, autoModHoistEnabled, autoModIgnoredChannels, autoModIgnoredRoles, autoModInvitesEnabled, autoModLinksBlacklist, autoModLinksEnabled, autoModLinksFollowRedirects, autoModLinksWhitelist, autoModLogEnabled, autoModMentionRolesEnabled, autoModMentionRolesMaxNumberOfMentions, autoModMentionUsersEnabled, autoModMentionUsersMaxNumberOfMentions, autoModModeratedChannels, autoModModeratedRoles, autoModQuickMessagesEnabled, autoModQuickMessagesNumberOfMessages, autoModQuickMessagesTimeframeInSeconds, autoModWordsBlacklist, autoModWordsEnabled, autoSubtractFakes, autoSubtractLeaves, autoSubtractLeaveThreshold, captchaVerificationFailedMessage, captchaVerificationLogEnabled, captchaVerificationOnJoin, captchaVerificationSuccessMessage, captchaVerificationTimeout, captchaVerificationWelcomeMessage, channels, getUpdates, hideLeftMembersFromLeaderboard, ignoredChannels, joinMessage, joinMessageChannel, joinRoles, lang, leaderboardStyle, leaveMessage, leaveMessageChannel, logChannel, modLogChannel, modPunishmentBanDeleteMessage, modPunishmentKickDeleteMessage, modPunishmentMuteDeleteMessage, modPunishmentSoftbanDeleteMessage, modPunishmentWarnDeleteMessage, mutedRole, prefix, rankAnnouncementChannel, rankAnnouncementMessage, rankAssignmentStyle

value

Value

No

The new value of the setting.

Examples

!config

!createInvite

Creates unique invite codes.

Usage

!createInvite <name> [channel] [maxUses] [expires] [temporaryMembership]

Aliases

  • !create-invite

Arguments

Argument

Type

Required

Description

Details

name

Text

Yes

The name of the invite code.

channel

Channel

No

The channel for which the invite code is created. Uses the current channel by default.

maxUses

Number

No

number --> The max amount of uses of the invite code

expires

Boolean

No

true or false --> Set if the invite will expires after 24 hours

temporaryMembership

Boolean

No

true or false --> Set if the invited users are granted as temporary members

Examples

!createInvite reddit
!createInvite website #welcome

!credits

Show developers and contributors of the bot.

Usage

!credits

Examples

!credits

!export

Export data of InviteLogger to a csv sheet.

Usage

!export <type>

Arguments

Argument

Type

Required

Description

Details

type

Enum

Yes

The type of export you want.

Use one of the following values: leaderboard

Examples

!export leaderboard

!fixRanks

Deletes any ranks where the role was deleted.

Usage

!fixRanks

Aliases

  • !fix-ranks

Examples

!fixRanks

!getBot

Get an invite link for the bot.

Usage

!getBot

Aliases

  • !get-bot

  • !invite-bot

  • !invitebot

Examples

!getBot

!graph

Shows graphs about various stats on this server.

Usage

!graph <type> [from] [to]

Aliases

  • !g

  • !chart

Arguments

Argument

Type

Required

Description

Details

type

Enum

Yes

The type of chart to display.

Use one of the following values: joins, joinsAndLeaves, leaves

from

Date

No

Start date of the chart

to

Date

No

End date of the chart

Examples

!graph joins
!graph leaves
!graph usage

!help

Display help.

Usage

!help [command]

Arguments

Argument

Type

Required

Description

Details

command

Command

No

The command to get detailed information for.

Use one of the following values: addInvites, addRank, ban, botConfig, botInfo, caseDelete, caseView, check, clean, cleanShort, cleanText, clearInvites, config, createInvite, credits, export, fixRanks, getBot, graph, help, info, interactiveConfig, inviteCodeConfig, inviteCodes, inviteDetails, invites, kick, leaderboard, lockdown, memberConfig, members, mute, permissions, ping, prefix, premium, punishmentConfig, purge, purgeUntil, ranks, removeInvites, removeRank, restoreInvites, setup, softBan, strike, strikeConfig, subtractFakes, subtractLeaves, support, tryPremium, unban, unhoist, unmute, warn

Examples

!help
!help addRank

!info

Show info about a specific member.

Usage

!info <user> [details] [page]

Aliases

  • !showinfo

Arguments

Argument

Type

Required

Description

Details

user

User

Yes

The user for whom you want to see additional info.

details

Enum

No

Request only specific details about a member.

Use one of the following values: bonus, members

page

Number

No

What page of the details to show. You can also use the reactions to navigate.

Examples

!info @User
!info "User with space"
!info @User members
!info @User bonus
!info @User members 4

!interactiveConfig

Interactive Config

Usage

!interactiveConfig

Aliases

  • !ic

Examples

!interactiveConfig

!inviteCodeConfig

Show and change the config of invite codes of the server.

Usage

!inviteCodeConfig [key] [inviteCode] [value]

Aliases

  • !invite-code-config

  • !icc

Arguments

Argument

Type

Required

Description

Details

key

Enum

No

The config setting which you want to show/change.

Use one of the following values: name, roles

inviteCode

Invite Code

No

The invite code for which you want to change the settings.

value

Value

No

The new value of the setting.

Examples

!inviteCodeConfig

!inviteCodes

Get a list of all your invite codes

Usage

!inviteCodes

Aliases

  • !invitecode

  • !invite-code

  • !invite-codes

  • !getinvitecode

  • !get-invite-code

  • !get-invite-codes

  • !showinvitecode

  • !show-invite-code

Examples

!inviteCodes

!inviteDetails

Shows details about where your invites are from.

Usage

!inviteDetails [user]

Aliases

  • !invite-details

Arguments

Argument

Type

Required

Description

Details

user

User

No

The user for whom you want to show detailed invites.

Examples

!inviteDetails
!inviteDetails @User
!inviteDetails "User with space"

!invites

Show personal invites.

Usage

!invites [user]

Aliases

  • !invite

  • !rank

Arguments

Argument

Type

Required

Description

Details

user

User

No

The user for whom you want to show invites.

Examples

!invites
!invites @User
!invites "User with space"

!kick

Kick a member from the server.

Usage

!kick <member> [reason]

Arguments

Argument

Type

Required

Description

Details

member

Member

Yes

Member to kick.

reason

Text

No

Why the member was kicked.

Examples

!leaderboard

Show members with most invites.

Usage

!leaderboard [page]

Aliases

  • !top

Arguments

Argument

Type

Required

Description

Details

page

Number

No

Which page of the leaderboard to get.

Examples

!leaderboard
!leaderboard 1mo
!leaderboard 30d 6

!lockdown

Lockdown a specific channel (Prevents anyone without special roles from sending messages)

Usage

!lockdown [-t value|--timeout=value] [channel]

Arguments

Argument

Type

Required

Description

Details

channel

Channel

No

The channel that you want to lock down.

Flags

Flag

Short

Type

Description

‑‑timeout

‑t

Duration

The timeout after which the lockdown automatically ends. Run the command again to end the lockdown manually.

Examples

!lockdown

!memberConfig

Show and change the config of members of the server.

Usage

!memberConfig [key] [user] [value]

Aliases

  • !member-config

  • !memconf

  • !mc

Arguments

Argument

Type

Required

Description

Details

key

Enum

No

The member config setting which you want to show/change.

Use one of the following values: hideFromLeaderboard

user

User

No

The member that the setting is shown/changed for.

value

Value

No

The new value of the setting.

Examples

!memberConfig

!members

Show member count of current server.

Usage

!members

Aliases

  • !member

  • !memberscount

Examples

!members

!mute

Mute a user

Usage

!mute [-d value|--duration=value] <user> [reason]

Arguments

Argument

Type

Required

Description

Details

user

Member

Yes

The user that should be muted.

reason

Text

No

The reason why this user is muted.

Flags

Flag

Short

Type

Description

‑‑duration

‑d

Duration

The duration to mute the user for

Examples

!permissions

Configure permissions to use commands.

Usage

!permissions [cmd] [role]

Aliases

  • !perms

Arguments

Argument

Type

Required

Description

Details

cmd

Command

No

The command to configure permissions for.

Use one of the following values: addInvites, addRank, ban, botConfig, botInfo, caseDelete, caseView, check, clean, cleanShort, cleanText, clearInvites, config, createInvite, credits, export, fixRanks, getBot, graph, help, info, interactiveConfig, inviteCodeConfig, inviteCodes, inviteDetails, invites, kick, leaderboard, lockdown, memberConfig, members, mute, permissions, ping, prefix, premium, punishmentConfig, purge, purgeUntil, ranks, removeInvites, removeRank, restoreInvites, setup, softBan, strike, strikeConfig, subtractFakes, subtractLeaves, support, tryPremium, unban, unhoist, unmute, warn

role

Role

No

The role which should be granted or denied access to the command.

Examples

!permissions

!ping

Ping the bot

Usage

!ping

Examples

!ping

!prefix

Shows the current prefix of the bot.

Usage

!prefix

Examples

!prefix

!premium

Info about premium version of InviteLogger.

Usage

!premium [action]

Aliases

  • !patreon

  • !donate

Arguments

Argument

Type

Required

Description

Details

action

Enum

No

The action to perform. None for premium info. check to check your premium status. activate to use your premium for this server.

Use one of the following values: Activate, Check, Deactivate

Examples

!premium
!premium check
!premium activate
!premium deactivate

!punishmentConfig

Configure punishments when reaching a certain amount of strikes.

Usage

!punishmentConfig [punishment] [strikes] [args]

Aliases

  • !punishment-config

Arguments

Argument

Type

Required

Description

Details

punishment

Enum

No

Type of punishment to use.

Use one of the following values: ban, kick, mute, softban, warn

strikes

Number

No

Number of strikes for this punishment to be used.

args

Text

No

Arguments passed to the punishment.

Examples

!punishmentConfig

!purge

Purge messages in a channel.

Usage

!purge <quantity> [user]

Aliases

  • !prune

Arguments

Argument

Type

Required

Description

Details

quantity

Number

Yes

How many messages should be deleted.

user

User

No

User whose messages are deleted.

Examples

!purgeUntil

Purge messages in a channel up until a specified message.

Usage

!purgeUntil <messageID>

Aliases

  • !purge-until

  • !prune-until

  • !pruneu

  • !purgeu

Arguments

Argument

Type

Required

Description

Details

messageID

Text

Yes

Last message ID to be deleted.

Examples

!ranks

Show all ranks.

Usage

!ranks [page]

Aliases

  • !show-ranks

  • !showranks

Arguments

Argument

Type

Required

Description

Details

page

Number

No

The page of the ranks list to show.

Examples

!ranks

!removeInvites

Removes a specified amount of invites from a user.

Usage

!removeInvites <user> <amount> [reason]

Aliases

  • !remove-invites

Arguments

Argument

Type

Required

Description

Details

user

User

Yes

The user to remove the invites from.

amount

Number

Yes

The amount of invites to remove.

reason

Text

No

The reason for removing the invites.

Examples

!removeInvites @User 5
!removeInvites "User with space" 23 Removed for cheating
!removeInvites @User -6 Added for apologizing

!removeRank

Remove a rank.

Usage

!removeRank <rank>

Aliases

  • !remove-rank

Arguments

Argument

Type

Required

Description

Details

rank

Role

Yes

The for which you want to remove the rank.

Examples

!removeRank @Role
!removeRank "Role with space"

!restoreInvites

Restore all previously cleared invites.

Usage

!restoreInvites [user]

Aliases

  • !restore-invites

  • !unclear-invites

  • !unclearinvites

Arguments

Argument

Type

Required

Description

Details

user

User

No

The user to restore all invites to. If omitted restores invites for all users.

Examples

!restoreInvites
!restoreInvites @User
!restoreInvites "User with space"

!setup

Help with setting up the bot and checking for problems (e.g. missing permissions)

Usage

!setup

Aliases

  • !guide

  • !test

  • !testbot

  • !test-bot

Examples

!setup

!softBan

Ban and then automatically unban a member from the server.

Usage

!softBan [-d value|--deleteMessageDays=value] <user> [reason]

Aliases

  • !soft-ban

Arguments

Argument

Type

Required

Description

Details

user

Member

Yes

User to ban.

reason

Text

No

Why was the user banned.

Flags

Flag

Short

Type

Description

‑‑deleteMessageDays

‑d

Number

Delete messages from the user this many days back.

Examples

!strike

Add strikes to a user

Usage

!strike <member> <type> <amount>

Arguments

Argument

Type

Required

Description

Details

member

Member

Yes

The member receiving the strikes

type

Enum

Yes

The type of the violation

Use one of the following values: allCaps, duplicateText, emojis, hoist, invites, links, mentionRoles, mentionUsers, quickMessages, words

amount

Number

Yes

The amount of strikes to be added

Examples

!strikeConfig

Configure strikes received for various violations.

Usage

!strikeConfig [violation] [strikes]

Aliases

  • !strike-config

Arguments

Argument

Type

Required

Description

Details

violation

Enum

No

Violation type.

Use one of the following values: allCaps, duplicateText, emojis, hoist, invites, links, mentionRoles, mentionUsers, quickMessages, words

strikes

Number

No

Number of strikes.

Examples

!strikeConfig

!subtractFakes

Remove fake invites from all users.

Usage

!subtractFakes

Aliases

  • !subtract-fakes

  • !subfakes

  • !sf

Examples

!subtractFakes

!subtractLeaves

Remove leaves from all users

Usage

!subtractLeaves

Aliases

  • !subtract-leaves

  • !subleaves

  • !sl

Examples

!subtractLeaves

!support

Get an invite link to our support server.

Usage

!support

Examples

!support

!tryPremium

Try the premium version of InviteLogger for free for a limited duration.

Usage

!tryPremium

Aliases

  • !try

  • !try-premium