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. Available to everyone by default (optional role restriction in Settings).
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 botlist.top 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 (disabled by default on new servers)
- Set the minimum account age in days (suggested starting point: 7 days)
Role-Gated Invite Counting
Use this when an external verification bot (or manual staff action) assigns a role after join, and you only want to credit the inviter once that role is granted — not at the moment of join.
- A member joins via a tracked invite — the invite is stored as pending (not yet on the inviter's real count).
- When the member receives the configured role, InviteForge credits the inviter and applies reward milestones if due.
- If the member leaves or the timeout expires before they get the role, the invite is not counted.
- Go to Dashboard → Settings → Role-gated invite counting
- Enable the feature and select the required role on the joined member (e.g. @Verified)
- Optionally set how many days a pending invite can wait (1–30, default 7)
- Save — then test with a secondary account joining via your invite and receiving the role
Member Verification
InviteForge Verify gates new members through a secure web flow at invite-forge.com/verify/[token]. Members confirm their Discord identity, get roles swapped automatically, and — when enabled — only verified joins count toward invite stats.
- A member joins your server
- The bot assigns an unverified role and sends a verify link (DM, channel, or both)
- The member opens the link and signs in with Discord
- On success, the bot swaps to the verified role and credits the inviter (if invite counting is enabled)
Go to Dashboard → Settings → Verification to enable the gate, pick roles, delivery mode (DM / channel / both), and optional timeout kick after 10 minutes.
Make sure the bot role is above your Verified and Unverified roles in Discord's role list, and that the bot has Manage Roles.
When members open the verify link, they click Continue with Discord on invite-forge.com. This OAuth step requests only the identify scope — enough to confirm their Discord user ID. It is not a bot invite link and does not add the bot to any server.
- /verify setup — how verification works + dashboard link
- /verify resend @member — resend the link (Manage Messages)
- /verify force @member — manually verify a pending member (Kick or Ban permission)
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. Available on all plans.
Optional public web leaderboard at invite-forge.com/lb/<guildId>. Off by default — enable under Dashboard → Settings → Leaderboard. The /leaderboard command is available to everyone unless you restrict it to roles.
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?+
- When Anti-Fake is enabled, any account whose Discord creation date is newer than the configured Anti-Fake Age threshold (suggested: 7 days).
- Anti-Fake is off by default on new servers. Enable it in Dashboard → Settings → Anti-Fake.
Why isn't an invite counted until the member gets a role?+
- You may have Role-gated invite counting enabled: the invite is credited only after the joined member receives a configured role (often from an external verification bot).
- Configure it under Dashboard → Settings → Role-gated invite counting. Do not enable InviteForge Verification at the same time.
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.