If you want to add the Collab.Land bot to your Discord server and create and manage TGRs (token-granted roles)...Welcome! You're in the right place!


Prior to adding the Bot:

1. Create your Discord server(s).
2. Create the Discord roles you want Collab.Land to manage. 

Adding the Bot: 

1. Sign in to Discord. 

2. Click here to add the Collab.Land bot and add a server to manage.




3. Add Collab.Land as an administrator for setup (you can remove it later)


4. The Collab.Land bot creates a collabland-config and a collabland-join channel. 


collabland-config: You will see this welcome message. By default, access goes to the person setting up the bot and any server admins.





collabland-join: this is where members verify using the "Let's go!" button. 


- Please do not delete or rename collabland-config or collabland-join.



Configuring your TGRs (token-granted roles) :


  1. Make sure Collab.Land is at the top of the server role hierarchy to ensure it properly manages the roles beneath it. 


Suggested Discord hierarchy:



  1. Head to the Collab.Land web portal. You will log in with your Discord account. 















  1. Select the server on the left. 

  1. Click on “TGRs” on the left. 



  1. Click on the + Select role button.



  1. Select a Discord role and click Apply. (If you do not see any roles you want, return to Discord to create them first.)


  2. Click on the role and then click "+ Add new" to add the configuration.

  3. Add your token details.



    Token Details Explained: 

  1. Description: Optional description of your TGR, only displayed in the Command Center for your reference.

  2. Chain type: Select the chain that your token is on from a dropdown list.

  3. Token type: Select the token type of your token from the dropdown list.


Note: When using the ERC-1155 token type, you must enter the token IDs for all tokens in your collection in the token ID section. Token IDs should be separated by one comma, and no spaces.

  1. Address: Input the contract address of your token

  2. Balance: Input the minimum amount, and maximum (optional) amount of tokens that are required to get the role.

  3. Attributes (optional): For NFT token types such as ERC-721, you can add specific metadata conditions. If your NFT contains metadata traits and values you can enter them by clicking on the Attributes button, and clicking on + Add metadata. 

    Note: You can find the metadata traits and attributes for your token by looking at the properties tab of the token on OpenSea.

  4. Once you have finished adding your metadata, click the Add Traits button or it will not be saved.