Register External Collection

The first section of this guide is EVM specific. For Solana, we support the metaplex standard. Importing a candy machine is very similar. Jump below for specific details about importing a Solana candy machine.

EVM Smart Contract Requirements

ERC-721, ERC-721a, ERC-1155

The mint function accepts address paramter and mints to that address

Crossmint treasury address(es) must be able to call your function unlimited times

Please note that currently only importing EVM and SOL primary contracts is self-serve. If you wish to import EVM or SOL secondary contracts, or Aptos and Sui contracts, please contact sales.

Import a Custom Contract

Navigate to Collections and click `New collection`

Enter Collection Information

This information is displayed in the NFT Checkout Pay Button, Storefront, and Claims page. You can edit it later.

Select `Import an existing contract` option

Select the Blockchain your contract is deployed on

Remember, Crossmint has staging and production environments. When working in the staging environment, choose the mainnet name. For example, if your contract is on the Polygon Amoy testnet, select Polygon.

Select `Import my own contract` option

Contract Address

Enter the address of your contract and the console will determine the contract type automatically.

Proxy or Sales Contract (optional)

Notice in the screenshot that the example has the same contract address that was entered in previous step. This indicates a basic setup where the purchase function is within the regsitered NFT contract. The only reason to change this is if purchases should be sent to a different contract address that is not the same as the NFT contract.

Most developers do not need to change this. If you are unsure, leave it as is. Transparent upgradeable contracts also do not need to use this setting and should use the beacon address in the previous step.

Contract ABI

As long as your contract is verified on the block explorer we can query the ABI automatically. If you have not verified your contract, you must enter the ABI manually.

Mint Function Currency

Unless you specifically deployed a contract that supports USDC you must leave the native currency selected. If you are unsure, leave it as is.

Select Mint Function

If you selected the native currency in previous step this will be a very short list. If you have multiple mint functions in your contract that you want to accept payments for, you must register each one separately.

USDC mint functions typically are NOT payable. Change currency selector to USDC to populate mint function list with valid options.

The mint function must accept an address parameter and mint to that address. If your mint function lacks this you’ll need to deploy a new contract or modify your existing contract.

Parameter for recipient address

After the mint function has been selected this will be a short list built from the function parameters of type address. If you have multiple options here ensure you select the correct one. Doing this incorrectly will result in the purchased NFTs being sent to the wrong address and they likely will not be recoverable.

Parameter for quantity

This will be a short list built from the function parameters of type uint256. If you have multiple options here ensure you select the correct one. Doing this incorrectly will result in the NFT checkout tools not being able to properly mint the correct quantity of NFTs.

Review details and click `Register collection` to complete

Next steps

Integrate the Crossmint SDK to start selling from your website. You can do this in three ways:

EASY: Use the Storefront to start accepting payments without writing any code.
MID: Add a Pay Button into your existing website or app. This button opens a Crossmint branded checkout flow, in a pop-up or new tab.
ADVANCED: Craft an Embedded NFT Checkout with custom UI into your website or app.

Introduction

Wallets

Minting Tools

Subscriptions

Verifiable Credentials

NFT Checkout

Authentication

Register External Collection

EVM Smart Contract Requirements

Import a Custom Contract

Next steps

Introduction

Wallets

Minting Tools

Subscriptions

Verifiable Credentials

NFT Checkout

Authentication

​EVM Smart Contract Requirements

​Import a Custom Contract

​Next steps

EVM Smart Contract Requirements

Import a Custom Contract

Next steps