InviteForge Docs
Everything you need to set up, configure, and get the most out of InviteForge.
Getting Started
Follow these steps to get InviteForge tracking invites in your server in under 2 minutes.
Click "Invite Bot" above and select your server. Accept all requested permissions — they are required for invite tracking, role rewards, and the ticket system.
Go to invite-forge.com and sign in with your Discord account. Select your server from the list.
In Dashboard → Settings, set a join channel and a leave channel. You can also use /setup in Discord for a quick setup.
InviteForge is now tracking all invites. Try /invites to see your stats or /leaderboard to see the top inviters.
Invite Commands
Available to all members in the server.
Check invite statistics for yourself or another user. Shows real, fake, left, bonus and net invites with a progress bar toward the next reward milestone.
Display the top recruiters in the server with real, fake and left-count breakdowns.
View server-wide invite analytics for a chosen time period — total joins, real joins, fake joins, leaves and retention rate.
Admin Commands
Require Manage Guild permission unless otherwise noted.
Quick-configure the join and leave message channels. Leave options empty to open the setup guide.
View the full bot configuration for this server: anti-fake status, channels, message templates, and auto-role rewards.
Give bonus invites to a user. These count toward their net invite total and reward milestones.
Remove bonus invites from a user.
Reset invite counts. Target a single user or leave empty to reset the whole server. Requires confirmation.
Exclude a channel from message count tracking (used for giveaway min-messages requirement).
Stop ignoring a channel — messages in it will count again.
List all channels currently excluded from message count tracking.
Post the InviteForge help desk panel in a channel. The panel contains quick-access buttons for common support topics.
Check or manage the premium status of this server.
Giveaways
Create and manage giveaways with optional entry requirements. Admin commands require Manage Guild permission. /giveaway list is public.
Create a new giveaway in a channel. You can optionally add requirements: minimum invites, required server membership, required role, or minimum messages.
End a giveaway early and immediately draw winner(s).
Reroll the winner(s) of an already-ended giveaway.
List all active giveaways in this server with prize, time remaining, participant count and a jump link.
Edit an active giveaway — change the prize, number of winners, or remaining duration.
Cancel an active giveaway without drawing any winner.
Info Commands
Available to everyone, no permissions required.
List all available commands with descriptions and welcome-message variable reference.
Get the link to add InviteForge to another server, along with a feature overview.
Check the bot latency — shows roundtrip time and WebSocket ping in milliseconds.
Vote for InviteForge on Top.gg and unlock the Supporter plan for 12 hours — free access to premium features.
Message Placeholders
Use these variables in your join message, leave message, and join DM templates. They are replaced with live values when a member joins or leaves.
Anti-Fake Detection
Anti-fake detection automatically flags accounts that are too new, helping keep your leaderboard accurate and preventing invite farming with fresh accounts.
When a member joins, InviteForge checks the account creation date. If the account is newer than the configured threshold, the join is marked as fake and excluded from the inviter's real invite count.
Fake invites are still recorded and visible — they just don't count toward leaderboard ranking or reward milestones.
Go to Dashboard → Settings → Anti-Fake to:
- Enable or disable anti-fake detection
- Set the minimum account age in days (default: 7 days)
Auto-Role Rewards
Automatically assign Discord roles to members when their inviters reach a certain number of effective invites. Great for gamifying growth.
- Go to Dashboard → Settings → Auto-Role Rewards
- Click Add Reward
- Select a role and set the invite milestone (e.g. 10 invites)
- Save — the role will be granted automatically on the next eligible join
Welcome Messages
Send customisable messages in a channel or directly in DM when a member joins or leaves your server.
Sent in your configured join channel when a member joins. Supports all placeholders and embed mode with a custom color.
Sent in your configured leave channel when a member leaves. Supports all placeholders and embed mode.
A private DM sent directly to the new member. Useful for onboarding instructions, invite links, or a personalised welcome.
Configure all messages in Dashboard → Settings → Messages. Use the Send Test button to preview your template before saving.
FAQ
Invites aren't being tracked+
- Make sure InviteForge has the Manage Guild permission (required to read invite data).
- The bot must have been online when the member joined. Invites that occurred while the bot was offline cannot be retroactively attributed.
- Check `/invites` to see if data is recorded.
- If the member was flagged as fake, their invite is excluded from the real count but still logged.
Why is my invite count showing 0?+
- No one has joined using your personal invite link yet.
- If you recently added the bot, historical joins before the bot was added are not tracked.
What counts as a "fake" invite?+
- Any account whose Discord creation date is newer than the configured Anti-Fake Age threshold (default: 7 days).
- You can adjust this threshold in Dashboard → Settings → Anti-Fake.
Can I track invites in multiple servers?+
- Yes — each server has its own isolated invite data, leaderboard, and settings.
Why did my auto-role reward not trigger?+
- The inviter must reach the milestone exactly (their count goes from below to at/above the threshold on that join event).
- Make sure InviteForge has the Manage Roles permission.
- The bot's role must be above the reward role in the server role hierarchy.
How do I cancel my Pro subscription?+
- Go to Dashboard → Premium and click Manage Subscription (Stripe customer portal).
- Your plan will revert to FREE at the end of the current billing period and premium-only settings will be automatically disabled.