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.
Analytics Dashboard
Beyond the /stats command, the web dashboard has a dedicated Analytics page with visual charts and a live activity log for your server.
- Charts — joins over the selected period, broken down into real and fake, alongside leaves and retention.
- Activity tab — a live, scrolling log of individual join, leave, and verification events as they happen.
Same limits as /stats: FREE — 24h or 7d. Supporter — adds 14d. PRO — adds 30d.
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 behind a single persistent message in your verification channel. Members consent in a native Discord form, then confirm their identity on a secure web flow at invite-forge.com/verify/[token] — get roles swapped automatically, and, when enabled, only verified joins count toward invite stats.
- A member joins your server and gets the unverified role
- They click Verify me on the fixed verification message in your verification channel
- A Discord form opens asking for their consent before anything is collected
- Submitting the form generates their personal, single-use link (valid 10 minutes), sent back to them privately in Discord
- They open the link and sign in with Discord to confirm their identity
- InviteForge scores the attempt and either verifies them immediately, holds them for manual review, or blocks them — see Anti-alt scoring below
- On a pass, 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 the role assigned after verification, the unverified role, the verification channel, an optional review channel and review role, a custom description for the verification message, and an optional auto-kick timeout.
Use the Post verification message button on the dashboard (or /verify send in Discord) to post the fixed verification message once verification is configured and enabled. The title, legal notice, footer, and buttons are fixed — only the description text is customizable.
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 Advanced anti-alt signals is on, and the member consents in the Discord verification modal, InviteForge collects a hashed browser fingerprint, a hashed technical cookie, a hashed Discord email, a hashed Discord server list, and a hashed IP address. Every signal is compared against other verified members on the same server — a match adds that signal's configurable point value to a weighted score.
- Below the flag threshold — the member passes automatically
- Between the flag and block thresholds — held behind the gate, posted to your review channel with Approve/Reject buttons and a ping to your review role
- At or above the block threshold — blocked automatically
The member always receives a plain-language Discord DM telling them the outcome — the underlying score and which signals matched are never shown to the member or to server staff. Signal weights and both thresholds are configurable in Dashboard → Settings → Verification.
Verifying always requests the identify scope — enough to confirm the member's Discord user ID. If advanced anti-alt signals are on and the member consented in the modal, the same sign-in additionally requests email and guilds to resolve the extended signals. It is not a bot invite link and does not add the bot to any server.
- /verify setup — how verification works + dashboard link
- /verify send — post (or repost) the fixed verification message in the verification channel (Manage Messages)
- /verify resend @member — DM the member a fresh link (Manage Messages)
- /verify force @member — manually verify a pending member (Kick or Ban permission)
- /verify stats [period] — verification funnel stats: verified, failed, expired, sessions, conversion rate (Manage Server; 24h free, 7d PRO/Supporter)
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 — falls back to your Default Embed Color (below) when the message has no color of its own.
Sent in your configured leave channel when a member leaves. Supports all placeholders and embed mode — falls back to your Default Embed Color (below) when the message has no color of its own.
A private DM sent directly to the new member. Useful for onboarding instructions, invite links, or a personalised welcome. Available on all plans.
Requires Supporter or Premium. A single guild-wide fallback color used for join/leave embeds that don't have their own color configured — a message's own color always takes priority over this default. Set it under Dashboard → Settings → Messages → Embed Color.
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.
Can someone other than the server owner access the dashboard?+
- Yes — set a Dashboard access role under Dashboard → Settings → Dashboard Access. Anyone holding that role can sign in and manage the server's dashboard, without becoming the recorded owner.
- They still sign in with their own Discord account — this only decides which servers appear in their server list.
Can I transfer my Premium subscription to another server?+
- Yes — go to Dashboard → Premium → Transfer Premium on the server that currently has the subscription, and enter the destination server's ID.
- You need to be an admin (or have Dashboard access) on the destination server for the transfer to go through. The source server reverts to Free once it's done.
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.
Get your personal, permanent invite link for this server. If you don’t already have one, InviteForge creates it for you in an available channel.
Look up who invited a specific member.
View the auto-role reward milestones configured for this server and your progress toward the next one.
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.
Giveaways
Create and manage giveaways with optional entry requirements. Admin commands require Manage Guild permission. /giveaway list is public.
Pick a role in Dashboard → Settings → Giveaways and InviteForge grants it to every winner automatically as soon as a giveaway ends — no extra step needed. Available on all plans. Make sure the bot's role sits above it in Server Settings → Roles.
Set a Claim Reward Text (up to 250 characters) in the /giveaway create wizard, and the ended embed gets a green Claim button. A winner who clicks it receives that text by DM.
If a winner has DMs closed for the server, they get an ephemeral message instead and can retry once they open them — their claim only counts once the DM actually goes through.
Give your giveaway embeds a custom color under Dashboard → Settings → Giveaways, instead of the default orange.
Give specific roles extra entries in the prize draw — configure roles and an entry count each under Dashboard → Settings → Giveaways → Extra Entries. A member holding several bonus roles gets all of them added together.
A role added to Dashboard → Settings → Giveaways → Bypass Roles lets anyone holding it skip every entry requirement (min. invites, min. messages, required role, required server) on every giveaway in the server — it's not an exemption from the role blacklist. Configuring the roles themselves is free on every plan.
Under Dashboard → Settings → Giveaways → Ended Giveaway: hide the "Participants" button so the entry list stays private once a giveaway is over, and/or set a custom message shown above the embed when it ends — up to 300 characters on Supporter, 1000 on PRO. Role mentions in that text will ping.
The Add InviteForge button always stays on the ended embed, on every plan.
Under Dashboard → Settings → Giveaways → Premium Visuals: add a banner image (a direct http(s) image link, shown full-width in the embed while the giveaway is active) and a custom emoji for the Enter button.
An unreachable banner or an invalid emoji is skipped automatically — it never breaks the giveaway post.
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.
Vote for InviteForge on Discord Bot List and unlock the Supporter plan for 12 hours — free access to premium features.
Report a bug to the InviteForge team through a quick form — title, steps to reproduce, expected vs actual behavior, and optional links.
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.