Gate pages, forms and secret content

Share pages, secret codes and links, or forms only with holders and members who meet a role's requirements.

To share content only with token holders or members who meet your requirements, put it behind a role in Guild. Create a role, give it requirements (hold a token or NFT on any of 50 EVM chains, be on an allowlist, follow an account on X, have a Discord role and more), and add what you want to share as the role's reward: a gated page or space, a secret (a code, link or message only role holders can reveal), or a form only role holders can fill out. Guild checks each member's connected wallets and accounts, opens the content to everyone who qualifies, and closes pages and forms again for members who stop qualifying.

If you don't have a guild yet, start at /create.

Pick the right kind of content

  • A gated page or space is for content that keeps changing or where members talk: a holders-only page of roles, a feed, an announcements channel or a chat. Members without the role see it in the sidebar with a lock.
  • A secret is for one piece of text: a discount code, a private link, a call link, instructions for the next step. Everyone with the role sees the same text.
  • A form is for collecting something from qualified members: applications, surveys, event sign-ups, feedback. Forms are part of the Pro plan and above.

One role can unlock all three at once.

1. Set up the role

  1. In the admin panel, open Spaces & roles and choose New role, then Empty role. The role opens in the inspector.
  2. Under Who gets it, press Add requirement and pick a type, for example Token balance, NFT Balance or an allowlist. See Requirements for every type.
  3. If you add more than one, set Members should meet to All or Any one. With three or more you can also pick Some and set how many.
  4. Give the role a name and press Save.

A new role starts open to everyone who joins; your first requirement replaces that default.

2a. Gate a page or space

  1. In Spaces & roles, pick the page in the Space menu, or add one with New space. A new space can start as Admins only, for now while you set it up.
  2. Press the audience button at the top of the page, for example Everyone can see it.
  3. Choose Role holders, tick the roles under Roles that open it, and press Save.

Each role you picked gets a View page permission reward for the page. You can also add it from the role's side: under Unlocks, press Add reward, pick Permission, and choose the page. To make the page a feed, announcements or a chat, change it on the Space card. See Pages and spaces.

2b. Share a secret code or link

  1. Select the role in Spaces & roles, and under Unlocks press Add reward.
  2. Pick Secret.
  3. Give it a title, such as "Holder discount", and optionally an image. Members see the title before they qualify, so keep the secret itself out of it.
  4. Write the code, link or message in Secret Text. Bold, lists and links work.
  5. Press Create Secret Reward.

Members who hold the role press Reveal Secret to read it and View Secret to read it again. See Secrets.

2c. Gate a form

  1. In the admin panel, open Forms and create the form. Optionally set Submissions per member (0 means unlimited).
  2. Select the role in Spaces & roles, and under Unlocks press Add reward.
  3. Pick Form (v2), choose the form under Choose a form (only forms not yet linked to a reward are listed), and decide on Automatic approval: on approves every submission at once, off lets you review them.
  4. Press Add form reward.

Members with the role see Open form on the reward card. You read, approve or reject responses in Forms, and download them with Export responses. See Forms.

What members see

Members sign in, connect the wallets and accounts your requirements check, and join or press Check access. Once they hold the role, gated pages open and form and secret rewards unlock on the role's card. Before that, they see what is locked and which requirements are left.

When someone stops qualifying

When a member no longer meets the requirements, for example after selling the token, they lose the role. Gated pages close for them again and they can no longer fill out the form. A secret they already revealed can't be taken back.

FAQ

Can I give each holder a different code?

No. A secret shows the same text to everyone who holds the role. For codes that must be unique per person, hand them out another way.

Can people who don't qualify see that the content exists?

By default, yes: a gated page shows in the sidebar with a lock, and a secret's title is visible on the role card. To hide the role itself, set its Who can see it to Secret or Hidden (Starter plan and above) or Self-reveal (Pro and above).

Do I need a paid plan?

Not for pages and secrets: roles, requirements, pages open to role holders and secret rewards work on every plan, Free included. Gated forms need Pro or above, and hiding roles with Secret or Hidden visibility needs Starter or above. Compare plans on the pricing page.

Can a form unlock another role?

Yes. Add the Submitted a form requirement to a second role. Only approved submissions count, so with Automatic approval off you decide who gets in.

Does access update if someone buys the token later?

Yes. Guild refreshes onchain data in the background, and a member can also press Check access to be checked right away.

All Guild docs