Welcome to the invite tracking documentation page 🔥

Configuration

Setup invite tracking logs :

Informations

Learn more about fake invites :

Best practises to ensure invites are tracked correctly :

Please note these docs are in an early state. They might be incomplete

Getting Started

Vote for the bot !

A) Using the dashboard

Then select your server in the list:

Once you've clicked, edit the settings to match with what you need and click on the invite section.

You should see something like that:

To enable invite logging in channels, tick the two switch on the right top of the frame

And below select channels where you want the join/leave messages to be sent

It is done 🎉

B) Using commands

To setup the invite tracking, you can use the /setLogs command

For join messages:

For leave messages:

With the dashboard

2. Select your server from the list. (You must have manage server permission)

3. Go to the invites messages section
4. You are now able to edit messages

   • Normal: When someone joins using someone else link

   • Invited themselves: When someone joins using its own link

   • Unknown inviter: When the bot is unable to determine who has invited a joining member

   • Vanity invite: When someone joins using a discord custom link (also called vanity invite)

Using commands

We've released the /setMessages commands to allow users to edit messages without the dashboard

1. Run the /setMessages command

2. Pick what message you want to edit

3. Customize your message using variables listed below ⏬

If you're an experimented or well advised InviteLogger user, you've probably seen that sometimes the bot consider invites as fake.

What is a fake invite ?

An invite is counted as fake when it doesn't match server defined parameters. These parameters can be account age, profile pic, if already joined the server...

How to configure the fake system ?

You can configure fake system parameters using the /fakeConfig command

You have setup invite tracking logs and sometimes, or even on each joins the bot send this horrible message: ''I am unable to tell you who invited memberName. Maybe a temporary invite."

This message can have a multitude of reasons, we'll try to list most common ones here.

Configurations problems

• Make sure the InviteLogger role has manage server permission in your server (this permission is needed for the bot to access to the invite list)

• Make sure the bot can manage every channels (otherwise the bot won't get the invite create event and miss some invites)

Invalid invites

• The bot is unable to track members which are joining using an 'about to be deleted' invite. (i.e a single use invite will be deleted after being used, or an invite with 6/7 uses too)

• The bot is unable to track oauth2 related joins

Problems on bot side

• The bot has just started, so its invite cache is empty, it should be filled after another join, or by using the /purgeCache command

• Bot is ratelimited on this endpoint, should be resolved after a few minutes

• Bot is experiencing lag which delays and fails invite tracking, should be resolved after a few minutes too

Click on a category to view the command list:

With the /fakeconfig invites, you can configure what requirements joining members must fill for their join to be counted as valid invite.

You can know the reason of a fake invite through the /info command

Fake parameters list

Here is the rewarding command list:

With the dashboard

Using commands

Placeholders

Placeholders (also called variables) allow you to customize join and leave messages following your needs

● For join and leave messages

● For join only messages

● For leave only messages

● With inviteLogger gold

Here is the invites related command list:

Here is the invites command list:

​

Here is the premium commands list:

Here is the config command list:

Description

Manage ranks giving / removal with a reaction menu.

Syntax :

How to read : <> = required [] = optional | = multiple argument type

/rankConfig

Permissions :

manageGuild

sendMessages, embedLinks, addReactions

Aliases :

ranksConfig

Examples:

/rankConfig

Cooldown:

15 seconds

Screenshots:

none

Description

Remove a rank previously created with the /addRank command.

Syntax :

How to read : <> = required [] = optional | = multiple argument type

/removeRank <@role | rankId>

Permissions :

manageGuild

sendMessages, embedLinks

Aliases :

rRanks, rRank, removeRanks

Examples:

/removeRank @inviter

Cooldown:

3 seconds

Screenshots:

none

To ensure that the bot functions correctly in your server, it needs specific permissions. Below is a list of required permissions, along with their purposes.

🔹 Essential Permissions

These permissions are mandatory for the bot to function properly.

🔹 Channel Permissions

The bot needs to verify its permissions per channel to ensure it can track invites and send messages in logging channels.

🔹 Logging Channel Permissions

If your bot logs events such as joins, leaves, or moderation actions, it requires specific permissions in those channels.

The bot checks these permissions in join logs, leave logs, and action log channels (if configured).

✅ How to Grant Permissions

1. Server-wide Permissions:

   • Go to Server Settings → Roles.

   • Select the Bot’s Role.

   • Ensure the bot has all required permissions in the "Permissions" section.

2. Per-Channel Permissions:

   • Right-click the channel → Edit Channel → Permissions.

   • Find the bot’s role and ensure it has the required permissions.

❌ What Happens if Permissions Are Missing?

If any of these permissions are missing, the bot may not function properly.

To check missing permissions, use the /diagnose command.

Here is the utils command list:

​

Description

Configure the role that will be given to a member when they reach a certain amount of invites.

Syntax :

How to read : <> = required [] = optional | = multiple argument type

/addRank <@roletogive> [Role explaination message]

Permissions :

Aliases :

Examples:

/addRank 10 @bigInviter Get this role when you have invited 10 persons

Cooldown:

4 seconds

Screenshots:

none

Here is the rewarding command list:

Click on a category to view the command list:

Description

Allow or block a certain user or role to access a command.

Syntax :

How to read : <> = required [] = optional | = multiple argument type

/setPermissions < @role | @user>

Permissions :

administrator

sendMessages, embedLinks

Aliases :

setPerms, permission, permissions

Examples:

/setPermissions @chaun14#1403

Cooldown:

3 seconds

Screenshots:

none

Description

Set the minimum day count since the account creation of the joining member. If their account was created before the given day count, the invite will be counted as fake.

Syntax :

How to read : <> = required [] = optional | = multiple argument type

/setFakeThreshold <daysCount>

Permissions :

manageGuild

sendMessages, embedLinks

Aliases :

fakeConfig

Examples:

/setFakeThreshold 7

Cooldown:

3 seconds

Screenshots:

none

Description

Add bonus invites to a member.

Syntax :

How to read : <> = required [] = optional | = multiple argument type

/addInvites @user [reason]

Permissions :

manageGuild

sendMessages, embedLinks

Aliases :

addinvite

Examples:

/addInvites @chaun14#1403 is the best sheep

Cooldown:

3 seconds

Screenshots:

none

Description

Gives the list of ranks that are obtainable with members invites number.

Syntax :

How to read : <> = required [] = optional | = multiple argument type

/ranks

Permissions :

sendMessages

sendMessages, embedLinks

Aliases :

ranks-reward, roles, rangs

Examples:

/ranks

Cooldown:

3 seconds

Screenshots:

none

Description

Fix problems related to the ranks giving system. It will process all members of the server to check if they have right roles. Please ensure the bot role is higher than the role(s) to give in the role list.

Syntax :

How to read : <> = required [] = optional | = multiple argument type

/ranks

Permissions :

sendMessages

sendMessages, embedLinks

Aliases :

rr

Examples:

/refreshRanks all -> This will refresh ranks of all members of the server /refreshRanks @member -> This will refresh ranks of the given member

Cooldown:

5 minutes

Screenshots:

none

Description

Change the bot's language.

Syntax :

How to read : <> = required [] = optional | = multiple argument type

/setLang <newLang>

Permissions :

sendMessages, manageGuild

sendMessages, embedLinks

Aliases :

lang, language

Examples:

/lang fr

Cooldown:

3 seconds

Screenshots:

none

Description

Set logs channels for the join and leave messages.

Syntax :

How to read : <> = required [] = optional | = multiple argument type

Slash command:

/setLogs <type: join | leave>

Regular commands:

/setLogs

Permissions :

manageGuild

sendMessages, embedLinks

Aliases :

setLog, setChannels, setChannel

Examples:

/setChannel

Cooldown:

3 seconds

Screenshots:

none

Description

Shows members joins and leaves charts.

Syntax :

How to read : <> = required [] = optional | = multiple argument type

/graph

Permissions :

sendMessages, manageMessages

sendMessages, embedLinks, sendFiles

Aliases :

Examples:

/graph

Cooldown:

3 seconds

Screenshots:

none

Here is the config command list:

Here is the invites command list:

​

Description

Show the invites leaderboard of a guild.

Syntax :

How to read : <> = required [] = optional | = multiple argument type

/leaderboard [full] [page]

Permissions :

sendMessages

sendMessages, embedLinks

Aliases :

lb, leader, lead, top

Examples:

/leaderboard /leaderboard full

Cooldown:

3 seconds

Screenshots:

none

Description

Remove bonus invites to a member.

Syntax :

How to read : <> = required [] = optional | = multiple argument type

/removeInvites @user <amount> [reason]

Permissions :

manageGuild

sendMessages, embedLinks

Aliases :

removeinvite

Examples:

/removeInvites @chaun14#1403 12 is a bad sheep

Cooldown:

3 seconds

Screenshots:

none

Description

See the invites amount of a member.

Syntax :

How to read : <> = required [] = optional | = multiple argument type

/invites [ @user | userid | username ]

Permissions :

sendMessages

sendMessages, embedLinks

Aliases :

davet, invs, inv, level, profile, profil, rank, invite

Examples:

/invites /invites @chaun14#1403

Cooldown:

3 seconds

Screenshots:

none

Description

Restore the deleted invites history of the server or of a member.

Syntax :

How to read : <> = required [] = optional | = multiple argument type

/restoreInvites [all | @user]

Permissions :

sendMessages, manageGuild

sendMessages, embedLinks

Aliases :

restoreInvite

Examples:

/restoreInvites all /restoreInvite @chaun14#1403

Cooldown:

3 seconds

Screenshots:

none

Description

Get all informations about a user.

Syntax :

How to read : <> = required [] = optional | = multiple argument type

/info < userId | @userMention | username > [ "members" | "bonus"] [page]

Permissions :

Aliases :

Examples:

/info @chaun14#1403 -> Will show everything

/info @chaun14#1403 members 3 -> Will show the third page of the invited member list

Cooldown:

3 seconds

Screenshots:

none

Description

Deletes the invites history of the server or of a member.

Syntax :

How to read : <> = required [] = optional | = multiple argument type

/resetInvites [all | @user]

Permissions :

sendMessages, manageGuild

sendMessages, embedLinks

Aliases :

clearinvite, clearinvites, resetInvite

Examples:

/resetInvites all /resetInvites @chaun14#1403

Cooldown:

3 seconds

Screenshots:

none

Description

Change the bot's prefix.

Syntax :

How to read : <> = required [] = optional | = multiple argument type

/setprefix <prefix>

Permissions :

manageGuild

sendMessages, embedLinks

Aliases :

Examples:

/setprefix !

Cooldown:

3 seconds

Screenshots:

none

Description

Import invites as bonus from invitemanager-based bots.

Syntax :

How to read : <> = required [] = optional | = multiple argument type

/importInvites

Permissions :

sendMessages, manageGuild

sendMessages, embedLinks

Aliases :

Examples:

/importInvites (.csv file as attachement)

Cooldown:

3 seconds

Screenshots:

Here is the premium commands list:

Description

Manage the premium source tracking system.

Syntax :

How to read : <> = required [] = optional | = multiple argument type

/sources < add | list | delete | setMessage> [id]

Permissions :

sendMessages manageGuild

sendMessages, embedLinks

Aliases :

sc, sourceConfig, sourcesConfig

Examples:

/sources add /sources list /sources setMessage /source delete 846721140696023071

Cooldown:

3 seconds

Screenshots:

none

Description

Check this server's premium status.

Syntax :

How to read : <> = required [] = optional | = multiple argument type

/premium

Permissions :

sendMessages, manageMessages

sendMessages, embedLinks

Aliases :

pro, gold

Examples:

/premium

Cooldown:

3 seconds

Screenshots:

Description

Manage the smartLeaderboard feature: an auto refreshing and pinned leaderboard

Syntax :

How to read : <> = required [] = optional | = multiple argument type

/smartLeaderboard < send | list | delete > [ message_id ]

Permissions :

Aliases :

Examples:

/smartLeaderboard send /smartleaderboard list /smartLeaderboard delete 846720330986946590

Cooldown:

3 seconds

Screenshots:

none

Description

Gives the list of ranks that are obtainable with members invites number.

Syntax :

How to read : <> = required [] = optional | = multiple argument type

/ranks

Permissions :

sendMessages

sendMessages, embedLinks

Aliases :

ranks-reward, roles, rangs

Examples:

/ranks

Cooldown:

3 seconds

Screenshots:

none

Here is the utils command list:

​

Description

Gives the list of ranks that are obtainable with members invites number.

Syntax :

How to read : <> = required [] = optional | = multiple argument type

/ranks

Permissions :

sendMessages

sendMessages, embedLinks

Aliases :

ranks-reward, roles, rangs

Examples:

/ranks

Cooldown:

3 seconds

Screenshots:

none

Description

Gives the list of ranks that are obtainable with members invites number.

Syntax :

How to read : <> = required [] = optional | = multiple argument type

/ranks

Permissions :

sendMessages

sendMessages, embedLinks

Aliases :

ranks-reward, roles, rangs

Examples:

/ranks

Cooldown:

3 seconds

Screenshots:

none

Description

Gives the list of ranks that are obtainable with members invites number.

Syntax :

How to read : <> = required [] = optional | = multiple argument type

/ranks

Permissions :

sendMessages

sendMessages, embedLinks

Aliases :

ranks-reward, roles, rangs

Examples:

/ranks

Cooldown:

3 seconds

Screenshots:

none

Description

Gives the list of ranks that are obtainable with members invites number.

Syntax :

How to read : <> = required [] = optional | = multiple argument type

/ranks

Permissions :

sendMessages

sendMessages, embedLinks

Aliases :

ranks-reward, roles, rangs

Examples:

/ranks

Cooldown:

3 seconds

Screenshots:

none

Miki discord bot

Miki and InviteLogger are teaming up to create the best experience for you to reward your members for inviting real people to your server.

Double Counter

Description

Gives the list of ranks that are obtainable with members invites number.

Syntax :

How to read : <> = required [] = optional | = multiple argument type

/ranks

Permissions :

sendMessages

sendMessages, embedLinks

Aliases :

ranks-reward, roles, rangs

Examples:

/ranks

Cooldown:

3 seconds

Screenshots:

none

Discover the new Miki X InviteLogger partnership!

🎁 Reward your server members with Miki experience for inviting new members!

Setup:

1. Invite InviteLogger

3. You're all done!

Hide left inviters

Select to hide or show inviters that have left the server on your leaderboard/smartleaderboard Setup: bot: Use the /advancedConfig menu command dashboard: Your server > Leaderboard > Hide left inviters

Log bot invites

Select to hide or show discord bots on your invite tracking logs and on your leaderboard/smartleaderboard

Setup: bot: Use the /advancedConfig menu command dashboard: Your server > Leaderboard > Hide Bots

Leaderboard style

Configure the visual look of your server leaderboard

Setup: bot: Use the /leaderboardConfigcommand then pick a style dashboard: not yet possible

Hide slash commands execution (Gold only)

Choose if slash commands execution should be shown to everyone on the server

Setup: bot: Use the /advancedConfig menu command dashboard: Your server > Commands> Slash command behavior

Delete command invocation message

Choose if the invocation message of a message command should be deleted by the bot

Setup: bot: Use the /advancedConfig menu command dashboard: Your server > Commands> Message commands behavior

Custom prefix

(deprecated since message commands are deprecated and only accessible by using the bot mention as prefix) Select a custom prefix for the bot to answer commands Setup: bot: use the /setprefix message command dashboard: Removed

Overview

Tutorial

Once you've something like this, it is now time to setup the fake system to work with Double Counter To do so we'll use the /fakeConfig command and add the double counter verification requirement as a mandatory requirement for an invite to be counted as valid.

Bot language

Choose which language you want the bot to interact in Setup: bot: Use the /setlang command dashboard: Your server > General setup > Language

More informations about invitelogger gold

More informations abour private bot instances

Feature list:

Subscribing

Unlock a nice graph to see how an inviter performed for the last 30 days

List all the joins from a specific member with /info mode:Members user:@user

List all the joins from a specific member with /info mode:Joins user:@user

You need to know from which of your links members are coming?

The source system is made for you !

This feature allows to link invite codes to an human friendly name, for better traffic understanding

List existing sources

You can list existing sources with the /sources list command

Show sources graph

⚡ NEW: You can now access to a nice source chart

You can get an overview of your sources with the /sources stats command

Setup sources

Example: You need to post your server invite link on your twitter bio and you want to know who comes from this link.

1- Create your source

Firstly you have to create an invite link which will be dedicated to this source.

Then run the /sources add <name:SourceNameHere> <code:inviteCodeHere> <give-role: yes | no> [description:Description of the source]

2- Setup the source in your join message

Edit your join message to add the {sourceMessage} placeholder which will be replaced by the source message

3- (optional) Edit the sourceMessage

To edit the default sourceMessage, you can use the /sources setMessage and click on the pen.

Get a fixed leaderboard refreshed every 15 minutes automatically in one of your server channel⭐

This feature allow your members to check their invite count without doing any commands, useful for invites contest.

To setup it just run the /smartleaderboard send command

The check invites button:

Invite generation system

This system allow the users to easily get their own invite link to share with their friends through a button below the smartLeaderboard. It also generate expiring links only that will avoid the struggle of reaching the 1000 invites code per server limit. ➡️When using this feature, you should remove the Create Invite permission from your server member This feature can be toggled though the /smartleaderboard list command by clicking on the 🔗 button

Users coming from this link will be credited to @member

Overview:

The invite deleter is a system made for large server which are struggling to keep their amount of invite code below the discord limit.

Configuration:

You can configure the system using the /inviteDeleterConfig legacy or slash command.

This feature allow you to hide specific members from the leaderboards and invite tracking

You can blacklist a member by running /blacklist add-member <user:@user> [reason: blacklist reason]

You can blacklist a role by running /blacklist add-role [reason: blacklist reason] then selecting a role in the list

Must be their first join on the server

This parameter requires joining members to join the server for their first time for their join to be counted as valid

Must recieve a server role

This parameter requires joining members to get a role for their join to be counted as valid

With invitelogger gold, you can add your own tooltip at the bottom of the /invites command.

Configure your tooltip message with the /advancedConfig command.

Premade leaderboard styles

Custom

Build your own leaderboard style with /leaderboardconfig [customized:Your leaderboard row here]

Placeholder / Variable list

This commands allows to have the list of user coming from a specific invite code. For example you have a specific invite code given only on your website, and you want how many members joined from there.

Subscribe to an InviteLogger private instance here:

1 - Create your discord bot

And click on the create application button

Put your bot name (Please don't use a public invite bot name / profile pic) and click on the create button.

Once created you will see something like this: Copy the Application id and send it to chaun14.

Once the application created, you need to create a bot inside your application.

Put your bot name and eventually a profile pic

And tick the three intents at the bottom of the page to make sure the bot works. ✅ Presence intent ✅ Server members ✅ Message

Once everything is done, scroll up and copy the token, then send it to chaun14.

2 - Customize your bot instance.

The bot itself is now ready to be started, we just need more informations about customization.

A - Embed color

Once the color is selected, copy the HEX code. (i.e #4287f5) then send it to chaun14.

B - Bot activity / status message

Each bot has a status / activity. It represent your bot identity and is a great advantage for your server.

You need to provide a status message for your bot, it could be your server name, a domain name, a private joke...

Export command

[
    {
        "id": "DISCORD USERID",
        "tag": "USERNAME#0000",
        "username":"USERNAME",
        "discriminator": "0000",
        "rank": USERRANK (INT),
        "maxRank": TOTAL LEADERBOARD RANK (INT),
        "valid": AMOUNT OF VALID INVITES (INT),
        "bonuses": AMOUNT OF BONUSES INVITES (INT),
        "fake": AMOUNT OF INVALIDATED INVITES (INT),
        "leave": AMOUNT OF INVITED WITH LEFT MEMBER (INT),
        "total": valid + bonuses + fake + leave (INT)
    }
]

Ranks system

With a private bot instance, the role reward feature is enabled, to use with caution.

Bot status

You are able to customize the bot status / activity

Embed color

The bot embed color can also be changed

Bot account customization

Help us translating InviteLogger & Invitelogger dashboard

If your language isn't there, feel free to contact us on our support server to add it 🌍

Once done a decent amount of translations, you can claim the Translator role on our support server & a free lifetime gold subscription.

InviteLogger

Once logon on the site, please contact us on our Support Server to be added in the project as Accent doesn't support public project yet.

Dashboard