Documentation

InviteForge Docs

Everything you need to set up, configure, and get the most out of InviteForge.

Open Dashboard →Invite Bot

Getting Started

Follow these steps to get InviteForge tracking invites in your server in under 2 minutes.

1
Invite the bot

Click "Invite Bot" above and select your server. Accept all requested permissions — they are required for invite tracking, role rewards, and the ticket system.

2
Sign in to the Dashboard

Go to invite-forge.com and sign in with your Discord account. Select your server from the list.

3
Configure channels

In Dashboard → Settings, set a join channel and a leave channel. You can also use /setup in Discord for a quick setup.

4
Done!

InviteForge is now tracking all invites. Try /invites to see your stats or /leaderboard to see the top inviters.

lightbulbMake sure InviteForge's role is at the top of the role hierarchy if you plan to use auto-role rewards — the bot can only assign roles that are below its own highest role.

Invite Commands

Available to all members in the server.

/inviteshow_to_vote Supporter

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.

OptionRequiredDescription
userNoThe user to check — defaults to yourself
Usage/invites [user]
lightbulbSupporter & PRO servers receive an Image Card (/invites) instead of a text embed.
/leaderboard

Display the top recruiters in the server with real, fake and left-count breakdowns. Available to everyone by default (optional role restriction in Settings).

OptionRequiredDescription
limitNoNumber of entries to show (3–25, default 10)
Usage/leaderboard [limit]
lightbulbFREE shows up to 25 entries. Supporter shows up to 100. PRO is unlimited. Public web URL is opt-in under Settings → Leaderboard.
/stats

View server-wide invite analytics for a chosen time period — total joins, real joins, fake joins, leaves and retention rate.

OptionRequiredDescription
periodNo24h · 7d · 30d (default: 7d)
Usage/stats [period]
lightbulbFREE: up to 7 days. Supporter: up to 14 days. PRO: up to 30 days.

Admin Commands

Require Manage Guild permission unless otherwise noted.

/setupManage Guild

Quick-configure the join and leave message channels. Leave options empty to open the setup guide.

OptionRequiredDescription
join-channelNoChannel where join messages are sent
leave-channelNoChannel where leave messages are sent
Usage/setup [join-channel] [leave-channel]
/configManage Guild

View the full bot configuration for this server: anti-fake status, channels, message templates, and auto-role rewards.

Usage/config
/bonus addManage Guild

Give bonus invites to a user. These count toward their net invite total and reward milestones.

OptionRequiredDescription
userYesThe target user
amountYesNumber of invites to add (1–10 000)
reasonNoAudit note
Usage/bonus add <user> <amount> [reason]
/bonus removeManage Guild

Remove bonus invites from a user.

OptionRequiredDescription
userYesThe target user
amountYesNumber of invites to remove (1–10 000)
reasonNoAudit note
Usage/bonus remove <user> <amount> [reason]
/reset-invitesAdministrator

Reset invite counts. Target a single user or leave empty to reset the whole server. Requires confirmation.

OptionRequiredDescription
userNoLeave empty to reset ALL users in the server
Usage/reset-invites [user]
/ignorechannel addManage Guild

Exclude a channel from message count tracking (used for giveaway min-messages requirement).

OptionRequiredDescription
channelYesThe text channel to ignore
Usage/ignorechannel add <channel>
/ignorechannel removeManage Guild

Stop ignoring a channel — messages in it will count again.

OptionRequiredDescription
channelYesThe text channel to un-ignore
Usage/ignorechannel remove <channel>
/ignorechannel listManage Guild

List all channels currently excluded from message count tracking.

Usage/ignorechannel list
/helpdesk setupManage Guild

Post the InviteForge help desk panel in a channel. The panel contains quick-access buttons for common support topics.

OptionRequiredDescription
channelNoChannel to post the panel in (default: current channel)
Usage/helpdesk setup [channel]
/premiumManage Guild

Check or manage the premium status of this server.

OptionRequiredDescription
checkNoView current plan and feature comparison
addNo[Owner] Manually activate premium
removeNo[Owner] Manually deactivate premium
debugNo[Owner] Show raw Stripe & cache data
Usage/premium <check|add|remove|debug>

Giveaways

Create and manage giveaways with optional entry requirements. Admin commands require Manage Guild permission. /giveaway list is public.

lightbulbActive giveaway limits: Free → 1, Supporter → 3, PRO → unlimited. Min invites, min messages, and required server are Vote/PRO-only. Required role is available on all plans.
/giveaway createManage Guild

Create a new giveaway in a channel. You can optionally add requirements: minimum invites, required server membership, required role, or minimum messages.

OptionRequiredDescription
channelYesChannel to post the giveaway in
prizeYesWhat you are giving away
durationYesDuration — e.g. 1h30m, 2d, 30m
winnersNoNumber of winners (1–20, default: 1)
Usage/giveaway create <channel> <prize> <duration> [winners]
lightbulbFREE: 1 active giveaway max. Supporter: 3. PRO: unlimited. Min invites, min messages, and required server membership are Vote/PRO-only.
/giveaway endManage Guild

End a giveaway early and immediately draw winner(s).

OptionRequiredDescription
idYesGiveaway ID
Usage/giveaway end <id>
/giveaway rerollManage Guild

Reroll the winner(s) of an already-ended giveaway.

OptionRequiredDescription
idYesGiveaway ID
Usage/giveaway reroll <id>
/giveaway list

List all active giveaways in this server with prize, time remaining, participant count and a jump link.

Usage/giveaway list
/giveaway editManage Guild

Edit an active giveaway — change the prize, number of winners, or remaining duration.

OptionRequiredDescription
idYesGiveaway ID
winnersNoNew number of winners (1–20)
prizeNoNew prize description
durationNoNew remaining duration — e.g. 1h
Usage/giveaway edit <id> [winners] [prize] [duration]
/giveaway cancelManage Guild

Cancel an active giveaway without drawing any winner.

OptionRequiredDescription
idYesGiveaway ID
Usage/giveaway cancel <id>

Info Commands

Available to everyone, no permissions required.

/help

List all available commands with descriptions and welcome-message variable reference.

Usage/help
/invite

Get the link to add InviteForge to another server, along with a feature overview.

Usage/invite
/ping

Check the bot latency — shows roundtrip time and WebSocket ping in milliseconds.

Usage/ping
/vote

Vote for InviteForge on botlist.top and unlock the Supporter plan for 12 hours — free access to premium features.

OptionRequiredDescription
infoNoCheck your current vote status and remaining time
leaderboardNoTop 10 voters this month
perksNoSee all rewards unlocked by voting
reminderNoToggle a DM reminder when your vote expires
Usage/vote <info|leaderboard|perks|reminder>

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.

PlaceholderReplaced with
{member}Username of the member who joined/left
{memberTag}Username#discriminator of the member
{memberMention}Pings the member (@mention)
{inviter}Username of the person who shared the invite
{inviterTag}Username#discriminator of the inviter
{inviterMention}Pings the inviter (@mention)
{inviterCount}Total effective invites the inviter now has
{code}The invite code that was used
{guild}Server name
{memberCount}Current total member count of the server
lightbulbExample: Welcome {memberMention} — invited by {inviterMention} ({inviterCount} invites)!

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.

How it works

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.

Configuration

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)
warningSetting the threshold too high may flag legitimate users. A value between 7 and 30 days is recommended for most servers.

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.

How it works
  1. A member joins via a tracked invite — the invite is stored as pending (not yet on the inviter's real count).
  2. When the member receives the configured role, InviteForge credits the inviter and applies reward milestones if due.
  3. If the member leaves or the timeout expires before they get the role, the invite is not counted.
Setup
  1. Go to Dashboard → Settings → Role-gated invite counting
  2. Enable the feature and select the required role on the joined member (e.g. @Verified)
  3. Optionally set how many days a pending invite can wait (1–30, default 7)
  4. Save — then test with a secondary account joining via your invite and receiving the role
warningDo not enable InviteForge's built-in Verification gate at the same time as role-gated counting — pick one verification method. InviteForge needs the Server Members Intent so it can detect role updates.
lightbulbIf the member already has the required role at join time, the invite can be credited immediately. Check /invites before and after granting the role to confirm the credit.

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.

How it works
  1. A member joins your server
  2. The bot assigns an unverified role and sends a verify link (DM, channel, or both)
  3. The member opens the link and signs in with Discord
  4. On success, the bot swaps to the verified role and credits the inviter (if invite counting is enabled)
Configuration

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.

Discord sign-in (OAuth)

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.

Staff commands
  • /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)
lightbulbBasic verification is free on all plans. PRO unlocks fingerprint alt detection, invisible captcha, 7-day funnel analytics, and alt cluster detection in Security settings.

Auto-Role Rewards

Automatically assign Discord roles to members when their inviters reach a certain number of effective invites. Great for gamifying growth.

Setting up rewards
  1. Go to Dashboard → Settings → Auto-Role Rewards
  2. Click Add Reward
  3. Select a role and set the invite milestone (e.g. 10 invites)
  4. Save — the role will be granted automatically on the next eligible join
Plan limits
FREE
3
reward milestones
how_to_vote Supporter
5
reward milestones
star PRO
10
reward milestones
lightbulbThe bot's role must be placed above the reward roles in Server Settings → Roles, otherwise Discord will block the assignment.

Welcome Messages

Send customisable messages in a channel or directly in DM when a member joins or leaves your server.

Join Message

Sent in your configured join channel when a member joins. Supports all placeholders and embed mode with a custom color.

Leave Message

Sent in your configured leave channel when a member leaves. Supports all placeholders and embed mode.

Join DM

A private DM sent directly to the new member. Useful for onboarding instructions, invite links, or a personalised welcome. Available on all plans.

Leaderboard URL

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.

Premium

InviteForge has two upgrade paths — a free one and a paid one.

how_to_vote Supporter
Free — vote on botlist.top and unlock the Supporter plan for 12 hours. Re-vote to extend.
star Premium
Paid subscription — unlocks all features including Custom Bot (Logo, Banner and description). Starts at 3.99€/mo.
FeatureFreehow_to_vote Supporterstar Premium
Leaderboard entries25100Unlimited
Analytics history7 days14 days30 days
Auto-role rewards3510
Member verification (gate)check_circlecheck_circlecheck_circle
Verification fingerprint & captchacheck_circle
Verification funnel analyticscheck_circle
Alt cluster detectioncheck_circle
Join & leave messagescheck_circlecheck_circlecheck_circle
Join DM messagecheck_circlecheck_circlecheck_circle
Image Card (/invites)check_circlecheck_circle
Active giveaways13Unlimited
Giveaway: Min. Invitescheck_circlecheck_circle
Giveaway: Required Servercheck_circlecheck_circle
Leaderboard URLcheck_circlecheck_circlecheck_circle
Beautiful stats image (/stats)check_circle
Custom Bot (Logo, Banner and description)check_circle
Priority supportcheck_circle
how_to_vote Supporter — Free
Vote on botlist.top every 4–6 hours to keep the plan active (12h Supporter perk per vote).
Vote on botlist.top →
star Premium — from 3.99€/mo
Cancel anytime · verification PRO tools, Custom Bot (Logo, Banner and description), alt detection & priority support
Upgrade to Premium →

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.
© 2026 InviteForge
HomeDashboardSupport