Invite tracking
See who invited each new member, post join and leave messages, track keyword invite links and reward your best inviters with roles.
On this page
- Before you start
- Set it up
- Set it up from Discord
- Settings explained
- Public invite messages
- Staff invite logs
- Invite reward roles
- Keyword invites
- Seeing the numbers
- Commands
- Examples
- Troubleshooting
- Nothing is posted when people join
- It says "Invited by Widget or Vanity URL"
- The wrong person got credit
- The reward role wasn't given
- "There is already an invite role level for 10 invites"
- "Roles with Administrator, Manage Server or Manage Roles permission can not be self-assigned"
- /invite create says it doesn't have permission
- A channel I set earlier now shows as not selected
- Related
Invite tracking works out which invite link each new member used and who created it. Buddy can announce it in a public channel, keep a private staff log of joins and leaves, give members a role when they've invited enough people, and create keyword links so you can see which promotion brings people in.
Before you start#
What can and can't be tracked:
- Invites created by members (and by Buddy with
/invite create) are tracked. - Joins through your vanity URL or the server widget can't be traced to a person. They're logged as "Invited by Widget or Vanity URL".
- Buddy keeps an up-to-date list of your server's invite links only while at least one invite channel below is set, so pick your channels before you start promoting.
Set it up#
It's under Growth in the sidebar.
In Public invite messages, pick a Join message channel (who invited each new member), a Leave message channel and, if you'll use reward roles, an Invite milestone channel. Click Save invite messages.
In Staff invite logs, pick a Join log channel and a Leave log channel. Use channels only staff can see. Click Save staff logs.
In Invite reward roles, pick a role, type the Invite Count needed and click Add. Repeat for each step, e.g. 5, 10 and 25 invites.
You don't have to use every channel. Each one works on its own, so leave any you don't want empty.
Set it up from Discord#
The invite channels can also be set in Discord: run /setup feature:Join & Leave Messages and
pick channels for Join messages, Join log, Leave messages, Leave log and Invite
milestones. Invite reward roles are still added on the dashboard.
Settings explained#
Public invite messages#
| Setting | What it does | Default |
|---|---|---|
| Join message channel | Posts an embed for every new member: their name, the new member count, who invited them, the inviter's total invites and the invite's keyword, if it has one. | None |
| Leave message channel | Posts a short line when someone leaves, with who invited them when Buddy knows. | None |
| Invite milestone channel | Posts a congrats message when a member earns an invite reward role. | None |
Staff invite logs#
| Setting | What it does | Default |
|---|---|---|
| Join log channel | Logs each join with the member's tag, who invited them and how old their account is. A short "joined the server" line is posted first, so a join is logged even if the invite lookup fails. | None |
| Leave log channel | Logs each leave with when they joined, the roles they had and who invited them (when known). | None |
Invite reward roles#
| Setting | What it does |
|---|---|
| Role | The role to give. Roles with Administrator, Manage Server or Manage Roles, the @everyone role and roles managed by a bot or integration can't be used. |
| Invite Count | How many members someone must invite to earn it. Whole numbers from 1. Each count can only have one role. |
How reward roles work:
- A member's invites are the number of different people who have joined through invites they created. People who later leave still count.
- The role is given the moment a new member joins through their invite and pushes them past a threshold. Buddy gives the highest role they qualify for and removes any lower invite reward roles they have, so they only hold one at a time.
- Each role is awarded once per member. Later invites don't repeat the role or the congrats message.
- Roles aren't given retroactively. If you add a 10-invite role and someone already has 12 invites, they get it the next time someone joins through one of their invites.
- To change the role for a count, delete that row (the trash icon) and add it again.
Keyword invites#
A keyword invite is a permanent invite link with a label, so you can see where people come from:
twitter, youtube-video, partner-server and so on.
Usually #welcome or #rules.
Type /invite create and enter a keyword. Spaces become dashes, and keywords are cut to 50
characters.
Buddy posts the keyword and link in the channel. The link never expires and has no use limit.
Discord reuses Buddy's existing permanent invite for a channel, so running /invite create again in
the same channel relabels that same link with the new keyword. Use a different channel for each
keyword you want to track separately.
Buddy creates keyword links, so joins through them are credited to Buddy as the inviter, not to the person who ran the command. Use keyword invites to measure promotions. To reward people for inviting friends, have them create their own invite in Discord.
Seeing the numbers#
- Dashboard → Top inviters: the main dashboard page lists each inviter with their keyword, how many members joined through them and how many of those later left. Click a column header to sort. Only invites that never expire are listed.
/invite stats: your server's top 20 invites by uses, with keyword, creator and use count. Only you see the reply./userinfo: shows which invite a member used, who invited them and the keyword.- Analytics: the Top invite keywords chart shows which keywords brought in the most joins.
Commands#
/invite can be used by anyone who can send messages, unless you limit it with
command roles.
/invite create <keyword> EveryoneCreate a new invite
/invite stats EveryoneShow invite stats
Examples#
Reward roles that give members something to aim for:
| Role | Invite Count |
|---|---|
Recruiter | 5 |
Ambassador | 15 |
Legend | 50 |
What members see in your Join message channel:
And in your Invite milestone channel, when Alex reaches 5 invites:
Nice work @Alex you have reached @Recruiter rank! 🎉
In the Leave message channel:
Sam left the server. Invited by Alex
Troubleshooting#
Nothing is posted when people join#
- Check the channel is selected and saved, and that Buddy can View Channel and Send Messages there.
- Buddy needs Manage Server to read invites. Without it, it can't tell which invite was used.
- Buddy lists missing permissions and other problems under Bot errors on your main dashboard page.
- If the channel list doesn't show a new channel, run
/setupand pick Update Channels and Roles for Website, then reload the dashboard.
It says "Invited by Widget or Vanity URL"#
The member joined through your vanity URL or server widget, which Discord doesn't link to a person. The join is still logged and counted.
The wrong person got credit#
Buddy compares invite use counts before and after each join. If two people join within a moment of each other, or an invite was created while no invite channel was set, the first match can be off. Set your channels before you start promoting so Buddy always has an up-to-date invite list.
The reward role wasn't given#
- Buddy needs Manage Roles, and its role must be above the reward role.
- The inviter must still be in the server when the new member joins.
- Roles aren't retroactive. They're checked when someone joins through that person's invite.
- Each role is only awarded once. If you removed it by hand, it won't be given again.
"There is already an invite role level for 10 invites"#
Each invite count can only have one role. Delete the existing row first, then add the new one.
"Roles with Administrator, Manage Server or Manage Roles permission can not be self-assigned"#
Reward roles can't carry powerful permissions. Pick a cosmetic role, or remove those permissions from
the role in Discord and run /setup → Update Channels and Roles for Website.
/invite create says it doesn't have permission#
Buddy needs Create Invite in that channel. Check the channel's permission overrides for Buddy's role.
A channel I set earlier now shows as not selected#
Pick it again and save that card. Each card has its own save button.