Skip to main content
All CollectionsHow to's
How to create a token-gated whitelist form in Bitcoin

How to create a token-gated whitelist form in Bitcoin

Updated over 2 months ago

In BlockSurvey, you can create a token-gated whitelist form on the Bitcoin Network based on Fungible(Bitcoin, Runes) or Non-Fungible Token(Ordinals) holdings. Token gating helps you further qualify your audience based on the holdings threshold. By this, you avoid spam, which leads to fully qualified lists for your presale preparation.

What are the ways you can token gate?

You can token gate in two ways:

  1. At the Welcome screen.

  2. At the Question level.

Here is a quick guide on how to set it up.

  1. Go to the Design screen and click on Add Question.

  2. Select the Bitcoin Network.

  3. Under the Token gating tab, click the Add Gating button. e.g., Let's Gate by users who have 1 BTC in their wallet. This means that the whitelist can be submitted only when there is a minimum of 1 BTC.

  4. Select BTC from the Gate by dropdown.

  5. Set the gating using the default values, Token decimals set to 8, and Minimum holding(s) set to 1.

  6. Adjust the minimum holding(s) and add multiple Gates by conditions if required.

  7. Once you have designed your form, click Publish and test it.

How it is shown for your respondents

  • When respondents click the Connect & Verify (Bitcoin) button on the taking screen, they will be prompted to connect their Bitcoin wallet.

  • After connecting, they will need to approve a verification message with their wallet, confirming ownership of the wallet address.

  • Only respondents holding at least 1 BTC in their wallet can move on to the next question or submit their responses.

  • Once verified, BlockSurvey will automatically collect the respondent's wallet address and public details.

These are the data that are being collected when the respondents submit their responses:

  • BTC Taproot Address(P2TR)

  • BTC SegWit Address(P2WPKH)

  • Network

  • Wallet Provider

  • Wallet Holdings

  • BTC Balance

  • Runes Balance

  • BRC-20 Balances

  • Total Count of Ordinals Holdings

  • 50 Recent Ordinals Metadata

Responses screen

Analytics screen

Try it now! Following these steps, you can easily create a token-gated whitelist form for Bitcoin in BlockSurvey, ensuring only the right audience can access your form.

Did this answer your question?