A clear way into your community.
Foyer connects verified NFT and token ownership to Discord roles. Here’s what happens on each side of the door.
Set up a server
- Connect Discord with an account that has Manage Server and Manage Roles.
- Invite Foyer. In Discord’s role settings, move its role above the holder roles it should manage.
- Create a role rule. Choose an existing role or create one, then add your NFT or token requirements.
- Saving that first rule starts your 7-day free trial. No credit card is required. If your server already has an active plan, nothing changes.
- Enable your rule, then open member verification from your overview. Connect a wallet and check the result before sharing the link. A role is marked as added only after Discord confirms delivery.
- Share the verification link from your overview. You can also use
/foyer setupin a Discord text channel to preview and publish a verification panel. Publishing again refreshes the panel Foyer already manages in that channel.
For a “Full set” role, add collection A and collection B to the same rule using Add collection or token. Set a minimum for each, then choose Meet every requirement. Choose Meet at least one requirement if either collection should qualify. Holdings can count across a member’s linked wallets.
Network switches save immediately. The community name, welcome message, and rule edits have their own Save button. Pausing a rule leaves existing roles in place.
Enforce role, what it does. This optional setting also covers roles assigned manually or by other bots. Members who have not verified with Foyer in this server lose that role. Verified members keep it if they qualify through any active rule for it.
When it runs. Enforcement is off by default and applies to existing holders after you save. Full scans run about once an hour, so manually assigned roles may remain until the next scan. Large servers and Discord rate limits can take longer.
What never removes a role. Temporary holdings-check errors do not remove roles, and pausing the rule stops enforcement.
Set up my serverGet your roles
Use the verification button in your Discord server, or run /verify. Connect Discord, then choose how to link your wallets: sign a readable message, verify through your OpenSea bio, or add a cold wallet through an existing delegation. You can combine holdings across up to ten wallets. Members never pay Foyer to verify.
Sign a wallet message
Signing is the recommended option and proves control directly from your wallet. An EVM signature covers all supported EVM networks; Solana and Bitcoin addresses are linked separately. Check that the message names foyer.gg and your Discord account. Linking does not request a transaction or token approval.
Verify with your OpenSea bio
Prefer not to sign? Open “Verify with your OpenSea profile” and enter the Ethereum / EVM or Solana wallet address you want to link. Foyer finds its public OpenSea profile and gives you a short four-word phrase.
- Copy or type the four words. Capital letters and hyphens work too.
- Open the profile shown, choose Edit, add the phrase on its own line in the main Bio, and save.
- Return to Foyer and choose “I’ve saved my bio. Verify wallet”. Foyer checks immediately and retries while OpenSea publishes the update.
The phrase expires after ten minutes. You can remove it after the wallet is linked. If your OpenSea account has several wallets, add each address separately using the same main profile, even if a wallet has its own bio. Foyer links only the address you entered.
Foyer does not connect to your wallet or request a signature with this option. OpenSea may ask you to sign in. Keep the wallet public and linked to that profile: Foyer checks this association again during role checks. Removing it stops those holdings from counting at the next check; temporary OpenSea errors preserve existing roles. A Coinbase Smart Wallet works with this option too, as long as the keys it was created with are still its owners. Bitcoin wallets use signing, and other contract wallets, such as Safe, use delegation.
Use a delegated cold wallet or Safe
Link the everyday EVM wallet you delegated to by signing the Foyer message. Open “Add delegated wallet”, enter your cold wallet or Safe address, and select the network where you created the delegation. Foyer reads existing wallet-wide delegate.xyz V1 or V2 delegations; this step does not ask your cold wallet to sign or send a transaction.
The everyday wallet must be linked with a signature; an OpenSea bio link cannot authorize a delegation. Foyer reads existing grants, so create any new delegation separately on delegate.xyz. Registry availability varies by network.
Only holdings on that network count. Add the same cold wallet again for another network. Collection, individual NFT and custom-rights delegations are not supported yet. All wallet links share the ten-wallet limit, and a wallet can be linked to only one Discord account.
Foyer rechecks the delegation during role checks, including the scheduled checks every 45 minutes. Revoking it stops those holdings from counting at the next check; use “Check again” to request one sooner. If the registry cannot be read, Foyer keeps existing roles and retries. Unlinking the signing wallet also removes delegated links that depend on it. Removing a Foyer link does not revoke a delegation on delegate.xyz.
CROP in Scarecrows
For CROP rules on Robinhood, the server administrator can enable “Include CROP staked in Scarecrows”. Foyer then adds wallet CROP and the deposited principal backing your Scarecrows across your verified and delegated wallets. For example, 10,000 CROP in a wallet plus 40,000 deposited qualifies for a 50,000 CROP requirement.
Unclaimed rewards do not count. Matured deposits count until withdrawn. Selling a Scarecrow moves its deposited balance to the buyer for the next role check. If the Scarecrow is in your directly verified wallet, you do not need delegation. Other staking protocols are not included.
Your role is marked as added only after Discord confirms delivery. Automatic checks keep reviewing your holdings; they run periodically, so sales and transfers are not reflected instantly.
After a successful check, holdings on every network are checked again every 45 minutes. On EVM networks, a detected transfer that involves your linked wallet and a collection or token in an active rule triggers an earlier check. Solana and Bitcoin transfers can take longer to appear while they confirm or reach an indexer. Use Check again for a fresh check at any time; you do not need to wait for the next automatic check. If a role is confirmed more than about 20 seconds after you started a check, Foyer tries to send you one Discord direct message saying it is ready.
Find my verification pageOne plan for your server
Foyer charges per Discord server, with no per-member fees or member-count pricing tiers. Your plan does not limit verified members, role rules or collection sales feeds. NFT trait roles, combined collection requirements, OpenSea bio verification, and delegated wallets are included. Each rule can combine up to ten requirements, and each person can link up to ten wallets.
These are configuration limits, not a guarantee of unlimited processing capacity. Check times depend on the number and complexity of requirements, ownership providers, and Discord. Members can always connect wallets and request role checks for free while the server’s service is active.
See annual pricingNetworks and assets
Supported EVM networks share one wallet connection. Role rules can check ERC-20 token balances, ERC-721 collection counts, or a specific ERC-1155 token ID. OpenSea collection links resolve to their chain and contract. Traits can narrow NFT requirements. For an ERC-721 collection looked up on OpenSea, you can also count only certain token IDs or ranges, such as 1-200. Use them when several collections share one contract. Staked holdings and native EVM coin balances are not supported yet.
Link a Solana wallet separately with a signed message or your OpenSea bio. NFT rules count verified collection members, including standard, programmable, Core and compressed NFTs. Token rules support SPL and Token-2022 mints with ordinary public balances. Confidential, interest-bearing and scaled-balance tokens are not supported yet.
Link a Bitcoin address with UniSat or Xverse for Ordinals collection, Rune token, and native BTC balance roles. Each payment or Ordinals address needs its own signature. Holdings count after confirmation and indexing; pending transfers keep existing roles unchanged. Ordinals collections use UniSat collection IDs, and Runes use their permanent block:transaction IDs. Bitcoin traits and Bitcoin sales feeds are not available yet.
On mobile, open your server’s verification link inside your Solana wallet’s browser. WalletConnect is currently available for EVM wallets. If ownership data is unavailable or too old, Foyer keeps your existing roles until a complete check succeeds.
NFT trait roles
In an NFT requirement, look up a supported OpenSea collection and open its trait filters. Choose a category, such as Rarity Tier, then select one or more values.
Any value per category (OR) is the default. Values within a category are alternatives; each counted NFT must match every category you add.
All selected values (AND) requires every selected value across the member’s linked wallets. Different NFTs can supply different values. For example, selecting Corn and Wheat requires holdings that include both traits. The minimum is the total number of matching NFTs, not a separate minimum for each trait.
Set the minimum number of matching NFTs needed for the role. Trait support depends on the collection’s available metadata. Bitcoin trait filters are not supported.
Collection sales feeds
In your dashboard, open Sales feeds, choose a supported OpenSea collection and a Discord channel, then enable the feed. Give Foyer permission to view the channel, send messages, and embed links.
New sales appear with available artwork and traits, the sale total, buyer and seller, and links to the NFT and transaction. Feeds check periodically, so messages may arrive a few minutes after a sale. Sales feeds are separate from holder role checks.
Move from Matrica, Vulcan, or Collab.Land
Open Settings, then Import settings, and choose your current bot. Take screenshots of its rules page, or copy its text, and Foyer drafts every rule for you to check. You can also download Foyer’s CSV worksheet and copy the requirements in yourself. For Collab.Land, use the Token Gating Rules (TGRs) in Command Center. Then map each rule to an existing Discord role.
Nothing is imported until you confirm each contract and amount. Direct exports from those bots and automatic account syncing are not supported. Imports cover minimum token balances, NFT collection counts, individual ERC-1155 token IDs, ERC-721 token IDs or ranges, and supported NFT traits. Keep unsupported conditions, including maximum balances, staking, rentals, and nested role logic, with your current bot.
Every imported rule starts paused. Review the complete requirements before enabling it, and disable the corresponding rule in your old bot so the two services do not compete. Members must verify their wallets with Foyer through signing, OpenSea, or a supported delegation; holder lists cannot replace verification. Foyer’s own JSON backups can also be imported.
Open your dashboardWhen something needs attention
I qualified, but the role is still pending.
Foyer retries Discord updates automatically. If the delay persists, ask a server admin to check that Foyer has Manage Roles and sits above the holder role. You can safely close the verification page while delivery is pending.
Ownership could not be confirmed.
A network or provider may be unavailable, or the rule may use an incorrect contract, NFT standard or token precision. Existing roles stay in place during an incomplete check. Try again shortly; admins can review the rule and activity.
What does a wallet signature allow?
Signing Foyer’s ownership message links the wallet to your Discord account. It is not a transaction. It’s free and can’t move tokens, list NFTs or approve spending. Before you sign, check that the request names foyer.gg and your Discord handle. Close anything that shows a price, a network fee, “approve” or “permit”.
Can I verify without signing with Foyer?
Yes. Use OpenSea bio verification for a public EVM or Solana wallet associated with your OpenSea profile. Add Foyer’s phrase to your main bio, verify, then remove it. OpenSea may require you to sign in to edit the bio. Bitcoin uses wallet signing; cold wallets and Safes can use a supported delegation to a signed EVM wallet.
Do I need to move NFTs out of my cold wallet?
No. If your cold wallet or Safe has a wallet-wide delegate.xyz V1 or V2 grant to your everyday EVM wallet, sign with the everyday wallet and add the cold wallet for that network. Foyer reads the grant and holdings. It does not create a delegation or ask your cold wallet to sign. Collection, individual NFT and custom-rights grants do not qualify.
My wallet is not listed.
Use the wallet’s browser extension or open the verification link in its mobile browser. Foyer supports signed messages from EVM accounts, Solana wallets, and UniSat or Xverse Bitcoin wallets. A cold wallet or Safe can be added through a wallet-wide delegate.xyz delegation to a signed EVM wallet. If you prefer not to sign, use the OpenSea bio backup for a public EVM or Solana wallet, or a Coinbase Smart Wallet that keeps its original keys. Direct contract-wallet signatures are not supported yet.
The collection or token is wrong.
Check the chain as well as the address. A trading-pool address is different from the token contract. ERC-721 rules count NFTs across a collection contract; ERC-1155 rules need a token ID. Token decimals must match the contract.
Discord says my session expired.
Connect Discord again. Your saved rules and linked wallets remain attached to the same Discord account.
What information is stored?
Foyer stores your Discord identity, signed, OpenSea-verified and delegated wallet links, server connections, verification results and role activity. Admins see shortened wallet addresses. Activity history is retained; account settings explain your data controls.
Your way in. Your assets stay yours.
Never share a seed phrase or approve a transfer to verify with Foyer. Verification does not move your assets.