Importing an NFT
Besides creating new NFTs, NFTeapot also allows you to import existing NFTs from your wallet into NFTeapot. The NFTs must currently be on one of our supported networks.
The contract must be a standard ERC-721 contract. Some contracts may not be compatible such as those that block transfers by using on-chain royalty enforcement mechanisms.
When you’re ready to import your NFTs into Shopify, navigate to Import Your NFTs
shown on the NFTeapot homepage. Alternatively, you can also access this page through the Import NFT
tab.
Step 1 - Create NFTeapot Consignor Smart Contract
- First we will deploy an intermediary Consignor smart contract that is required to facilitate the NFT transfer. The contract will be unique to your store. Make sure you select the same blockchain your NFTs have been minted on.
- Check to accept the Consignor Development Policy, Fulfillment Fees, and Terms of Service .
-
Once you click
Continue
, the smart contract may take a few minutes to be deployed. We will send an email to your store email address once the smart contract is ready.
Step 2 - Approve NFTs
Once deployed, you must grant approval to the Consignor smart contract address to import the NFTs. You will need the following pieces of information:
- Consignor smart contract address
- NFT smart contract address
- NFT token ID(s)
The Consignor smart contract address will be displayed in NFTeapot:
The following steps will guide you through finding the NFT smart contract address and token IDs (if you do not already have them) and granting approval to the Consignor smart contract. These steps show you how to approve tokens one at a time. However, you can also use the setApprovalForAll
function to approve all the tokens within a single smart contract.
- Navigate to OpenSea ( https://opensea.io/ ) and connect the wallet that holds the NFTs you wish to import
-
From
Profile
, navigate to the NFT(s) you wish to import -
Click on
Details
and make note of the NFT’s Token ID
- Click on the contract address (hyperlink) and it will open the corresponding blockchain explorer in a new tab.
-
Navigate to the
Contract
tab, clickWrite Contract
, and connect your wallet by clickingConnect to Web3
.
-
Once connected, click on
approve
.
-
Fill in the
to (address)
(the Consignor smart contract address from NFTeapot) andtokenId (uint256)
(found on OpenSea → Details about NFT) and clickWrite
to grant approval:
- Accept the MetaMask prompt to approve this transaction then navigate back to NFTeapot to continue the import process.
Step 3 - Import NFT Data
-
In the Import NFT window, put the
Smart Contract Address
for the NFTs (found on OpenSea → Details about NFT, not the Consignor address) andToken IDs
(also found on OpenSea → Details about NFT) which can be inputted as one token ID per line or as a comma separated list:
-
Click
Import NFTs
and NFTeapot will begin the import process which could take a few minutes per NFT. You can close the page after importing has begun and it will continue to process in the background. You will receive an email when the import is complete. -
You can view the progress of any imports in the NFT Import Queue under
Import New NFT
-
Once the NFTs have been successfully imported, they will appear under
Published NFTs
Frequently Asked Questions 🧩
Why doesn't the imported NFT display the expected image and instead displays a placeholder?
This issue could happen for a few reasons. NFTeapot retrieves some images via URL and the URL may be invalid, or the URL host is (temporarily or permanently) unreachable. Another reason could be that the media type is not supported or the file may be larger than our limit of 100MB. In this case, you can manually upload the media to the Shopify product listing.
Why can't I import an NFT that I have in my wallet?
The NFT must have been minted on a supported blockchain network with a compatible smart contract. You must also import it on the same blockchain that it was minted on. For example, you cannot import an Ethereum NFT into Polygon. Please make sure all the steps have been followed correctly and contact us if you continue to have issues.
Types of Errors 🐛
The following types of errors can occur under Status
in the import queue.
Error Message | Troubleshooting |
---|---|
Permission Failed | This means that something failed while NFTeapot was checking the consignor approval. You should confirm that 1) the token contract address is correct and exists on the blockchain that you are trying to import on and 2) that the smart contract has the required ERC-721 functions. |
Not Approved | NFTeapot was able to query the specified token contract address, but the consignor address has not been granted approval to transfer the specified token ID. You should double check that you've called approve(address, uint256) or setApprovalForAll(address, boolean) with the appropriate parameters. |
Metadata Invalid | This error occurs when the metadata’s title field does not exist. You should verify that the metadata JSON for the specified token ID has a title field. |
Unknown Error | If this error occurs, you should contact us at [email protected] |