> ## Documentation Index
> Fetch the complete documentation index at: https://docs.formo.so/llms.txt
> Use this file to discover all available pages before exploring further.
# Form builder
> Build and customize token-gated forms, waitlists, and surveys for your web3 community with drag-and-drop fields and wallet-connected responses.
Launch forms, waitlists, and surveys for your community with the best form builder in web3.
* 🔑 **Token gating.** Gate access by token ownership, NFT collections, or other onchain credentials.
* ✅ **Verified socials.** Verify Twitter accounts, Discord usernames, Farcaster, and more.
* 🎨 **Custom branding.** Customize your backgrounds, colours, and logo to match your brand.
* 🎨 **Template library.** Choose from a variety of form templates or build your own.
* 🌐 **World ID** proof-of-personhood verification.
***
## How to create your first token-gated form
Build and launch a token-gated form in under 10 minutes. This guide walks you through creating a form, adding token requirements, customizing branding, and viewing responses.
### Step 1: Create a new form
1. Go to the [Formo Dashboard](https://app.formo.so)
2. Click **Forms** in the left navigation
3. Click **Create Form**
4. Choose a template or start from scratch:
* **Waitlist** - Collect emails and wallet addresses
* **Survey** - Gather feedback from your community
* **Application** - Accept applications for grants, allowlists, etc.
* **Blank** - Start with an empty form
Templates come with pre-built questions you can customize. Starting from a template saves time.
### Step 2: Add form fields
The form builder uses a drag-and-drop interface. Add fields by clicking the **+** button or dragging from the sidebar.
**Available field types:**
| Field | Use case |
| ------------------- | ------------------------------------------------------------ |
| **Wallet** | Capture connected wallet address (required for token gating) |
| **Email** | Collect email addresses |
| **Short Text** | Single-line responses |
| **Long Text** | Multi-line responses |
| **Multiple Choice** | Select one option from a list |
| **Checkboxes** | Select multiple options |
| **Twitter** | Verify and capture Twitter handle |
| **Discord** | Verify and capture Discord username |
| **Farcaster** | Verify and capture Farcaster ID |
### Step 3: Enable token gating (optional)
To restrict form access based on token ownership:
1. Click **Settings** in the form builder toolbar
2. Toggle **Token Gating** to enable
3. Click **Add Requirement**
4. Configure your requirement:
* Select **ERC-20** as the type
* Choose the chain (Ethereum, Base, Arbitrum, etc.)
* Paste the token contract address
* Set minimum balance (e.g., 100 tokens)
* Select **NFT** as the type
* Choose the chain
* Paste the NFT contract address
* Optionally set minimum quantity
* Select **Contract Read** as the type
* Choose the chain
* Paste the contract address and ABI
* Select a read function (e.g., `balanceOf`, `stakedAmount`)
* Set the comparison operator and expected value
* See [Contract Read guide](/features/token-gated-forms/token-gating#contract-read)
* Select **World ID** as the type
* Users must verify with World ID before submitting
* See [World ID integration](/features/token-gated-forms/world-id)
You can add multiple requirements with AND/OR logic.
### Step 4: Customize branding
Make your form match your brand:
1. Click **Design** in the form builder toolbar
2. Customize:
* **Logo** - Upload your project logo
* **Background** - Set a color or upload an image
* **Colors** - Match your brand colors
* **Font** - Choose from available fonts
### Step 5: Publish and share
1. Click **Publish** in the top right
2. Copy your form URL (e.g., `forms.formo.so/your-form`)
3. Share the link with your community
### Step 6: View responses
As responses come in, view them in the dashboard:
1. Go to **Forms** > select your form
2. Click the **Responses** tab
3. You'll see each submission with:
* Wallet address
* Form answers
* Token verification status
* Submission timestamp
### Example: NFT holder feedback form
Here's a practical example of a token-gated survey:
| Setting | Value |
| ----------------- | ------------------------------------------------------------- |
| Template | Survey |
| Token requirement | NFT: Your collection address |
| Minimum holdings | 1 NFT |
| Questions | "How did you hear about us?", "What features would you like?" |
| Branding | Your logo, brand colors |
Only users holding at least 1 NFT from your collection can submit the form.
## FAQ
Token gating supports EVM-compatible chains (Ethereum, Base, Arbitrum, Optimism, Polygon, and more) as well as Solana. See the full list of [supported chains](/chains/overview).
Yes. You can configure multiple token gate conditions and choose whether users must meet all conditions (AND) or any one condition (OR). See [token gating](/features/token-gated-forms/token-gating) for details on configuring multi-condition gates.
You can verify Twitter/X, Discord, Farcaster, Telegram, and more. Additional verification options include Solana wallet, World ID, Human Passport, and Contract Read conditions. Social verification helps you build richer profiles and prevent sybil submissions.
Yes. You can add your logo, set brand colors, customize the background, and configure the form layout. Forms are designed to be embeddable on your own site or shareable as standalone links.
## Next Steps
Learn about all token gating options
Add proof-of-personhood verification