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.
admin_panel_settingsBy default only the server owner can sign in to a server's dashboard. To let staff or moderators manage it too, set a Dashboard access role under Dashboard → Settings → Dashboard Access — anyone holding that role gets full dashboard access without becoming the server's recorded owner.

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.

What you'll see
  • 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.
Period limits

Same limits as /stats: FREE — 24h or 7d. Supporter — adds 14d. PRO — adds 30d.

lightbulbFind it under Dashboard → Analytics. The Activity tab is also reachable directly at Dashboard → Activity.

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 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.

How it works
  1. A member joins your server and gets the unverified role
  2. They click Verify me on the fixed verification message in your verification channel
  3. A Discord form opens asking for their consent before anything is collected
  4. Submitting the form generates their personal, single-use link (valid 10 minutes), sent back to them privately in Discord
  5. They open the link and sign in with Discord to confirm their identity
  6. InviteForge scores the attempt and either verifies them immediately, holds them for manual review, or blocks them — see Anti-alt scoring below
  7. On a pass, 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 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.

Anti-alt scoring (PRO)

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.

Discord sign-in (OAuth)

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.

Staff commands
  • /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)
lightbulbBasic verification is free on all plans. PRO unlocks advanced anti-alt signals with weighted scoring, invisible captcha, 7-day funnel analytics, and alt cluster detection in Security settings. Auto-kick only ever removes members who never started verification at all — it never kicks someone mid-verification or awaiting manual review.

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 — falls back to your Default Embed Color (below) when the message has no color of its own.

Leave Message

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.

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.

Default Embed Color

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.

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 Discord Bot List 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 & captcha——check_circle
Verification funnel analytics——check_circle
Alt cluster detection——check_circle
Join & leave messagescheck_circlecheck_circlecheck_circle
Join DM messagecheck_circlecheck_circlecheck_circle
Default embed color—check_circlecheck_circle
Image Card (/invites)—check_circlecheck_circle
Active giveaways13Unlimited
Giveaway: Min. Invites—check_circlecheck_circle
Giveaway: Required Server—check_circlecheck_circle
Giveaway: Extra Entries (bonus roles)1 role2 roles5 roles
Giveaway: Reward Claim Text——check_circle
Giveaway: Follow-up Message——check_circle
Leaderboard URLcheck_circlecheck_circlecheck_circle
Beautiful stats image (/stats)——check_circle
Custom Bot (Logo, Banner and description)——check_circle
Priority support——check_circle
how_to_vote Supporter — Free
Vote on Discord Bot List every 12h to keep the plan active (12h Supporter perk per vote).
Vote on Discord Bot List →
star Premium — from 3.99€/mo
Cancel anytime · verification PRO tools, Custom Bot (Logo, Banner and description), alt detection & priority support
Upgrade to Premium →
Transfer Premium to another server

Moved your community to a new server, or want to switch which server keeps the paid plan? Under Dashboard → Premium → Transfer Premium, a PRO server can move its active subscription to any other server InviteForge is already in — the source server reverts to Free once the transfer completes.

infoYou must be an admin — or have Dashboard Access (see Getting Started) — on the destination server for the transfer to be allowed. This only moves an existing subscription; it does not create a new one, so it's not available on the Free or Supporter plan.

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.

/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.
/create-invite

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.

Usage/create-invite
lightbulbRequires the bot to have the Create Instant Invite permission in a text channel.
/invited-byhow_to_vote SupporterManage Messages

Look up who invited a specific member.

OptionRequiredDescription
memberYesThe member to look up
Usage/invited-by <member>
lightbulbRequires an active vote or PRO — without one you’ll see a prompt to vote or upgrade.
/rewards

View the auto-role reward milestones configured for this server and your progress toward the next one.

Usage/rewards
lightbulbRewards are configured in Dashboard → Settings → Auto-Role Rewards.

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.
Winner role

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.

Claim button & reward DM
star PRO

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.

Embed color
how_to_vote Supporter

Give your giveaway embeds a custom color under Dashboard → Settings → Giveaways, instead of the default orange.

Extra entries (bonus roles)

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.

FREE
1
bonus role
how_to_vote Supporter
2
bonus roles
star PRO
5
bonus roles
Requirement bypass roles

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.

how_to_voteSupporter+ can also switch on Show in giveaway embed, which lists those roles directly on the giveaway post as plain text — it never pings.
Ended giveaway customization
how_to_vote Supporter

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.

Premium visuals
star PRO

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.

/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. PRO servers can also set a Claim Reward Text (up to 250 characters) in the creation wizard.
/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
/vote

Vote for InviteForge on Discord Bot List 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>
/bugreport

Report a bug to the InviteForge team through a quick form — title, steps to reproduce, expected vs actual behavior, and optional links.

Usage/bugreport

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 — already includes the unit word ("5 invites", or "3 uses" for a vanity URL join), so don't add "invites" after it yourself
{vanityUrl}The server's vanity URL code (e.g. "stealanegg") when the member joined via it — empty otherwise
{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})! — no need to add "invites" yourself, {inviterCount} already includes it.
infoFor a join via the server's vanity URL, {inviter}/{inviterTag}/{inviterMention} resolve to Vanity URL and {inviterCount} shows the link's total uses. For a join via a bot's OAuth2 authorization, they resolve to that bot's tag with (OAuth2) appended, and {inviterCount} shows how many members joined through it. Neither counts toward a real member's invite leaderboard.
© 2026 InviteForge
HomeDashboardSupport