Skip to main content

ERC721 collections

Use the ERC721 token type for NFT collections using the ERC-721 standard across all of Collab.Land's supported EVM chains and the equivalent NFT standards for other blockchains.

Create TGRs for ERC721 Collections​

Collab.Land supports both balance-based and attributes-based TGRs for ERC721 collections.

Create a Balance-Based TGR for ERC721 Collection​

info

Balance-Based TGRs mean that a member will receive a role if they hold the minimum number of tokens or more from the ERC721 NFT collection.

To create a Balance-based TGR for an ERC721 NFT collection in Discord, follow these steps:

  1. Log in to the Command Center at https://cc.collab.land using Discord.

  2. From the left panel, select the server in which you would like to create the TGR. Then, click on "TGRs".

  3. Click the "+ Select Role" button and choose the Discord role you would like to use for your TGR.

  4. You will be taken to the TGR configuration page. Fill in the fields to create your TGR. If any information provided is incorrect, an error message will appear. The fields include:

    • Description (optional): A description of your TGR that will only be displayed in the CC for reference purposes.

    • Chain Type: The blockchain network that the token for this TGR is on. See the full list of Collab.Land-supported chains and corresponding token types.

    • Token Type: The type of token used for the TGR.

    • Address: The contract address of your token.

    • Token ID (optional): Give the specific tokenIds of the tokens required to obtain the role.

    • Balance: The minimum and maximum (optional) amount of tokens required to obtain the role.

  5. Set the minimum amount of tokens (required)

  6. Set the maximum amount of tokens (not required)

  7. Click “Save”

Your balance-based TGR is ready! A complete balance-based TGR should look like this:

Create a balance-based TGR

Create an Attributes-Based TGR for ERC721 Collection​

This type of TGR is used to create roles based on ownership of specific kinds of NFTs from a collection.

For example, an admin can use an Attributes-Based TGR to check for a BAYC ape with blue fur in the member's wallet.

tip

Check out Collab.Land's ERC721 Attributes-based TGR tutorial.

To create an Attributes-based TGR for an ERC721 NFT collection in Discord, follow these steps:

  1. Log in to the Command Center at https://cc.collab.land using Discord.

  2. From the left panel, select the server in which you would like to create the TGR. Then, click on "TGRs".

  3. Click the "+ Select Role" button and choose the Discord role you would like to use for your TGR.

  4. You will be taken to the TGR configuration page. Fill in the fields to create your TGR. If any information provided is incorrect, an error message will appear. The fields include:

    • Description (optional): A description of your TGR that will only be displayed in the CC for reference purposes.

    • Chain Type: The blockchain network that the token for this TGR is on. See the full list of Collab.Land-supported chains and corresponding token types.

    • Token Type: The type of token used for the TGR.

    • Address: The contract address of your token.

    • Token ID (optional): Give the specific tokenIds of the tokens required to obtain the role.

    • Balance: The minimum and maximum (optional) amount of tokens required to obtain the role.

  5. Set the minimum amount of tokens (required)

  6. Set the maximum amount of tokens (not required)

  7. Since you have chosen to create an Attributes-based TGR, when you picked the ERC721 token type, an “Attributes” button appeared next to the “Balance” option.

  8. Select “Attributes”.

  9. Click on the “+ Add Metadata” button.

  10. A window will appear, allowing you to enter the Trait and its Value.

    Add metadata attributes TGR requirements
danger

Attributes-based TGRs must be EXACT matches to the Traits and Values specified in the contract's metadata.

  1. If you want to add multiple Traits:

  • Select AND if all the traits should match. If you choose the AND option (default) then the member will have to hold one NFT with all of the trait value pairs which have been listed here.

  • Select OR if at least one of the traits should match. If you choose the OR option, the member will have to hold one NFT with at least one of the trait value pairs which have been listed.

  1. Click on the “Add Trait” button.

  2. Click “Save”

Your Attributes-based TGR is ready! This is what it should look like:

Final appearance of an attributes-based TGR for an ERC721 NFT collection

Create TGRs for ERC7160 Collections​

Collab.Land currently supports ERC7160 collections through OpenSea only. Congratulations to Perils of Sēsē by All Seeing Seneca for being the first to use this new NFT standard.

note

The ERC7160 token standard extends ERC721 with multiple metadata URIs.

To create a TGR for an ERC7160 collection:

  1. Log in to the Command Center at https://cc.collab.land.

  2. From the left panel, select the server in which you would like to create the TGR. Then, click on "TGRs".

  3. Click the "+ Select Role" button and choose the Discord role you would like to use for your TGR.

  4. Enter the token details for your NFT.

    • Description (optional): A description of your TGR that will only be displayed in the CC for reference purposes.
    • Chain Type: Mainnet
    • Token Type: Opensea
    • Collection Name: The collection name of your token
    • Balance: The minimum and maximum (optional) amount of tokens required to obtain the role

  5. Click "Save"

caution

The collection name must match the OpenSea collection exactly. Copy the collection name from the URL of the collection on OpenSea.

For example, if the URL of your collection is "opensea.io/collection/liquiddreams2-0", then use liquiddreams2-0 as the Collection Name.

Create a TGR for an ERC7160 NFT collection