Docs/Features/Token Gating
Core Feature

Token Gating

Assign roles based on ERC-20 token holdings. Perfect for community tokens, DAO governance tokens, and more.

How It Works

Token gating works similarly to NFT verification, but checks for fungible token balances instead of NFT ownership.

1

Connect Wallet

Members link their wallet to their Discord account

2

Check Balance

WardX checks the wallet for your specified token balance

3

Assign Role

Members meeting the threshold receive the configured role

Common Use Cases

DAO Governance

Gate voting channels and discussions to members holding governance tokens.

Community Tokens

Create tiered access based on how many community tokens members hold.

Premium Access

Offer exclusive channels to members holding a minimum token balance.

Whale Identification

Automatically identify and tag large token holders in your community.

Supported Chains

Token gating is available on the following EVM-compatible networks:

EthereumPolygonArbitrumOptimismBaseAvalancheBNB Chain

Setting Up Token Gating

1

Navigate to Token Gating

Open the WardX dashboard, select your server, and click on "Token Gating" in the sidebar.

2

Create a Token Rule

Click "Add Rule" and configure:

  • Rule Name: A descriptive name (e.g., "$TOKEN Holders")
  • Chain: Select the blockchain network
  • Contract Address: The token's contract address
3

Set Balance Tiers

Configure role assignments based on token balance:

Example Tier Setup

  • Tier 1: 100+ tokens → "Member" role
  • Tier 2: 1,000+ tokens → "Active Holder" role
  • Tier 3: 10,000+ tokens → "Whale" role

Note: Token amounts are entered as whole units. Decimals are handled automatically based on the token's contract.

4

Enable and Save

Toggle the rule to "Enabled" and click Save. Members can now verify their token holdings.

Automatic Token Detection

Smart Contract Reading

When you enter a contract address, WardX automatically fetches the token name, symbol, and decimals from the blockchain. This ensures accurate balance calculations without manual configuration.

Continuous Verification

Auto Re-verification

WardX periodically re-checks token balances. If a member's balance drops below the threshold, their role is automatically removed. This ensures your gated channels stay exclusive to qualifying holders.

Price Volatility

Token gating is based on token quantity, not USD value. If you want to gate based on a minimum USD value, you'll need to periodically update your threshold amounts as token prices change.