Invite Tracking
Codex Helper records which invite each new member used, and who made that invite.
| Tier | Free |
| Command | /invites |
| Who can use | Admins |
| Also on dashboard | Yes |
Turning it on
Section titled “Turning it on”/invites settingsThat opens the control panel. Pick Invite tracking from the menu to switch it on.
Codex Helper needs the Manage Server permission to see your invite list. Without it nothing can be tracked, and the panel says so.
From the same panel, pick Announce channel to have each join posted somewhere. Every new member then gets a line saying who invited them and how many invites that person is now on. The panel refuses a channel Codex Helper cannot post in, rather than saving a setting that would silently do nothing. Once a channel is set, Stop announcing joins clears it while keeping the tracking itself on.
The panel also shows how many joins have been recorded and what share of them were matched to someone.
Seeing the results
Section titled “Seeing the results”/invites leaderboardThe top ten inviters in your server, over the last 30 days by default.
Use the period option to change the window: last 7 days, 14 days, 30 days, or all time. The footer always says which one you are looking at.
Thirty days is the default on purpose. On an all-time board, whoever invited the most people a year ago stays on top forever, which tells you nothing about who is recruiting now.
Some joins will say unknown, and that is honest
Section titled “Some joins will say unknown, and that is honest”Discord never tells any bot which invite somebody used. The only way to work it out is to remember every invite’s use count and check which number went up when someone joins.
That means it cannot always tell:
- Two people join in the same second. Two counts go up and there is no way to say who came through which.
- Somebody joined while Codex Helper was offline. There is no earlier count to compare against.
- They used your server’s vanity link. That is recorded as the vanity link rather than a person.
When Codex Helper cannot be sure, it records the join as unknown instead of guessing. A wrong name on a leaderboard people compete over is worse than a blank, because nobody can tell it is wrong.
This is true of every bot that tracks invites. Any bot that never says unknown is guessing.
What is stored
Section titled “What is stored”One row per join: who joined, who invited them, which code, and when. Kept permanently, so you can look up a member months later.
Members who joined before you turned tracking on have no record at all.
On the dashboard
Section titled “On the dashboard”The Invite Tracking page of the dashboard has the same on/off switch and announce channel, plus the leaderboard and a list of recent joins. It also shows what share of your joins were successfully attributed, so you can see the coverage rather than assume it.
Commands
Section titled “Commands”| Command | What it does |
|---|---|
/invites settings | The control panel: on/off, announce channel, and how much has been matched |
/invites leaderboard | Top ten inviters, over 7, 14 or 30 days, or all time |