HelpCommunities
Set up a token-gated community
jorge-campo
and
on May 14, 2024

Status app is currently in beta stage
The Status app is currently in its beta stage. This means the application is still undergoing active development, and certain features described in this document may function differently or be unavailable within the app.
info
You can only set up token-gated communities using Status desktop.

By default, a new Status Community is open and available for everyone to join. As a community Owner, you can use token-based permissions to create a token-gated community.

Only people with the required tokens can join and participate in the token-gated community. For instance, you can configure a token-based permission that requires members to hold a certain amount of DAI and ETH tokens to join. Or, you can restrict access to users in a particular ENS domain, such as acme.eth.

info
In addition to tokens, community Owners can require manual approval to join their communities. Token-based permissions and manual approval work independently.

Token requirements can be useful to ensure that your community members have a certain level of commitment or interest in the topic of the community. If you run an organization with an ENS domain, you can also set up a token-gated community for holders of your ENS domain only (for example, alice.acme.eth or bob.acme.eth).

  • Use the
    Become member
    token-based permission to set up a token-gated community.
  • You can set up token-based permissions with existing tokens or tokens you have minted and distributed via airdrops.
  • In a token-gated community, members must always meet and keep the token requirements. Community members not holding the required tokens lose access to the community automatically.
  • Use channel permissions to make one or more channels private while keeping your community open.
  • To transform a token-gated community into an open one, delete the
    Become member
    token-based permissions    .

This procedure outlines how to use permissions to set up a token-gated community. For additional information on configuring these permissions, check out Set up your community permissions.

Community Owners customize permissions using three different variables:

Who holds
,
Is allowed to
and
In
.

  1. 1
    From the navigation sidebar, click your community.
  2. 2
    On top of the channel sidebar, click your community logo and then click
    Permissions
    .
  3. 3
    Click
    Add permission
    .
  4. 4
    For the
    Who holds
    variable, select the tokens and amounts (for assets and collectibles) members must hold to join your community. You can choose and combine up to five assets, collectibles or ENS names.
  5. 5
    For the
    Is allowed to
    variable, select
    Become member
    .
  6. 6
    For the
    Who holds
    variable, make sure your community is selected.
  7. 7
    Click
    Create permission
    . The new permission takes effect immediately.
tip
For each permission, tokens are linked by
AND
operators. This means the new permission takes effect when the holder owns all the tokens. If you want to use the
OR
operator instead, create additional permissions with different
Who holds
values. You can create a maximum of five different Become member permissions.