Skip to main content

​
Setting up tokens

First thing you have to do when setting up token gating rules in your server is to enter your token or NFT collection details into Flipsuite. To do it, go to the Gating tab in your community dashboard and switch to the Tokens tab.

Empty gating tokens tab

Click the Add new token button to get started, and add your token details. Depending on the blockchain you have selected you might be asked for:
  1. Token standard:
    Whether it’s a coin, NFT collection or something else.
  2. Contract address:
    Contract address of your token, or a verified creator address in case of Solana NFTs.
  3. Token ID:
    ID of a specific token if your collection allows multiple copies of the same NFT.
  4. Token name:
    Symbol of your token or name of your NFT collection. It’s purely cosmetic.
After successfully adding the token details you will get redirected to token settings panel:

Token details tab

You can now use your token for creating token gating rules in your community. Optionally, you can go to the Appearance tab to change your token appearance, including its icon and emoji.

Token appearance tab

​
Adding staking contracts (optional)

Starter only

With Flipsuite, you can verify tokens and NFTs even if they are staked or locked in external contracts. To add your staking contract to Flipsuite, go to the Contracts tab.

Token contracts tab

Click the Add staking contract button and enter your staking contract address. If you’re using Flipsuite for the first time, and your token or collection is on the EVM chain, there is a high chance that your contract isn’t supported yet which is indicated by the red status badge:

Not supported contract

If that’s the case, please open a ticket in our support server and provide us with your smart contract details, including:
  1. Blockchain your token is on
  2. Staking contract address or link
  3. Contract ABI (if your contract isn’t verified on the blockchain explorer)
We’ll do our best to add support for the provided contract as soon as possible. Unless your staking contract is unusually complex, we add support within 24 hours. Once we do, your contract’s status color should change to green:

Supported contract

Now your token gating rules for this token should read users’ staked token balance from the provided smart contract as well.

​
Adding token gating rules

To add your first token gating rule, go to the Rules tab, click the Create new rule button, and choose Token Gating Rule to get started.

Empty rules tab

​
Adding rule for a token

There a couple of settings you can set when creating a token gating rule for a token, including:
  1. Role to grant:
    Discord role to grant if the user meets the requirements.
  2. Min and max amounts:
    Amount of tokens that’s required to get the role.
  3. Include Flipwallets?
    Whether to include user’s Flipwallet balance during verification.
  4. Count only staked tokens?
    Whether to count only staked tokens during verification.

Token Gating Rule form

​
Adding rule for an NFT collection

When creating a token gating rule for an NFT collection, you get a few more settings to set:
  1. Role to grant:
    Discord role to grant if the user meets the requirements.
  2. Min and max amounts:
    Amount of NFTs that’s required to get the role.
  3. Specific token IDs:
    List of specific token IDs to check during verification. Perfect for granting unique roles for holding specific NFTs.
  4. Required NFT attributes:
    List of attributes an NFT must have in order to qualify.
  5. Include Flipwallets?
    Whether to include user’s Flipwallet balance during verification.
  6. Count only staked tokens?
    Whether to count only staked tokens during verification.

Token Gating Rule form

Attribute-based rules are available only on the Starter plan.

​
Recipes

Below are some of the most common ways to set token gating rules:

​
Overlapping roles

The most common approach to structuring your roles is to make them overlap. For example, if you have 3 rules, each representing a different holder tier, you would configure them like this:
  1. @Tier1 - Minimum of 1,000 tokens
  2. @Tier2 - Minimum of 10,000 tokens
  3. @Tier3 - Minimum of 100,000 tokens
You skip the maximum amount option entirely, so the person who holds at least 100,000 tokens, gets all of the roles. It makes the server management of roles a lot easier, because channels that are locked to the first tier will be accessible by the higher roles as well.

​
Separated roles

This approach, on the other hand, makes it so every person in your server can only have one of the tiers assigned to them at once. All you have to do is extend the example above and set the maximum amount option as well:
  1. @Tier1 - Minimum of 1,000 tokens, maximum of 10,000 tokens
  2. @Tier2 - Minimum of 10,000 tokens, maximum of 100,000 tokens
  3. @Tier3 - Minimum of 100,000 tokens
This way a person who holds 50,000 tokens only gets the @Tier2 role, a person who holds at least 100,000 only gets the @Tier3 role and so on.
Maximum amount option is exclusive, which means that if you set it to 100,000, people who hold exactly 100,000 tokens won’t get the @Tier2 role.

​
Only counting staked tokens

If your token or NFTs can be staked, it’s common to create separate roles for people who stake their tokens. This way you can detect who’s in your project for the long game, and reward them by giving these roles extra perks like access to alpha channels, reward multipliers, access to exclusive battlegrounds and so on - it’s up to you.

​
Attribute based rules (NFTs only)

If you have an NFT collection, it likely has different attributes/traits, some of them being more common, and some of them being ultra-rare. People love to feel special, and creating extra roles for holding an NFT with a specific attribute or set of attributes will make people in your community feel just like that.

​
Result

After configuring and adding token gating rules, the Rules tab should now be populated with the gating rules you’ve created.

Rules tab

​
What’s next?

You are ready to set up a gating verification message in your server now!