Invite Tracking
Attribute joins to invite creators and show member and server invite totals.
How it works
Invite tracking compares Discord invite usage around join events, records attribution when Discord provides enough information, and exposes member statistics and a leaderboard.
Before you start
- Allow Airwavy to manage or inspect server invites as required by Discord.
- Keep in mind that vanity, expired, deleted, or ambiguous invites may not be attributable.
Configure it
- Open Invite Tracking in the dashboard.
- Choose the required join-announcement channel, decide whether departures should update active and left totals, and enable tracking.
- Save, create a fresh Discord invite, join with a test account, and inspect /invites.
How attribution works
- Airwavy compares Discord's invite-use totals immediately around a member join and credits a creator only when one consumed invite can be identified.
- A member cannot receive credit for inviting themselves.
- Recently consumed one-use invites can still be attributed when Discord removes the code after use.
- When several codes changed, a vanity URL was used, or Discord data is unavailable, Airwavy records the join without guessing an inviter.
Statistics and announcements
- /invites reports a member's recorded total, currently active, departed, and available invalid/fake classifications.
- When leave tracking is enabled, a tracked departure moves one invite from active to left; disabling it leaves those totals unchanged.
- The dashboard and /inviteleaderboard order eligible current inviters using active and total invite context. The public dashboard view shows up to five entries on free servers and up to 100 with premium.
- The optional join announcement mentions the joining member but displays the inviter without notifying them.
Expected result
- Attributable joins increase the creator's recorded invite count.
- /invites shows member statistics and /inviteleaderboard ranks tracked inviters.
Common errors
A join has no inviter
Discord does not expose a definitive inviter for every join. Vanity URLs, simultaneous invite use, deleted codes, and missing invite access can make attribution unknown.
Saved changes do not take effect
Reload the feature page and confirm the saved values. Then verify that the selected Discord channel or role still exists and that Airwavy can access it.
Discord reports missing permissions
Check the permission on both the server role and the target channel. Channel overwrites and role hierarchy can deny an action even when the server-level permission is present.