Skip to main content

3. Register a collection

A collection refers to a deployed token smart contract, the tokens of which can be freely transacted (ie. minted, traded, bought and sold) on Immutable X's layer 2.

Each collection belongs to a project.


  1. Register a collection
  2. Update a collection

1. Register a collection

Environment ownership cannot be transferred

Once a collection is created for an environment for the first time, that environment will be registered to the Ethereum wallet address used to create that collection and it cannot be changed.

Make sure that the wallet you use to create a collection is one that you have adequate security management for and will use for all collections for that environment.

Follow the 3. Add a collection steps in the imx-examples repository.

2. Update a collection

Follow the Update collection steps in the imx-examples repository.

Fields that cannot be updated:

  • contract_address
  • metadata_api_url - if this field is modified AFTER minting, existing assets using the previous URL will not be modified, however, the new URL will be used for new mints.

Increase project collection limits

Collection limits can be increased by contacting support about your project. Be sure to include your reason for an increase.

IMX Whitepaper IMX Tokenomics Block Explorer Careers Contact Us