thirdweb: Create an NFT Marketplace with thirdweb and IPFS

Learn how to create an NFT marketplace with thirdweb and IPFS.

What is thirdweb?

thirdweb is an easy-to-use platform to build Web3 applications with code or no-code. thirdweb makes creating and deploying apps such as NFT collections or NFT marketplaces easy. thirdweb can be used with objects stored on IPFS, so objects stored in a Filebase IPFS bucket can be seamlessly uploaded for use with a thirdweb app.

Read below to learn how to create an NFT marketplace with thirdweb and IPFS.


1. Start by navigating to the thirdweb dashboard and connecting your crypto wallet.

2. Select ‘Deploy New Contract'.

3. Under 'NFTs', select ‘NFT Collection’:

Then select 'Deploy Now'.

4. Give your NFT collection a name, icon, and description, then confirm that the recipient address is your crypto wallet address.

For this tutorial, we’ll be using the Mumbai testnet, so we are using a Mumbai wallet.

5. Select ‘Deploy Now’ and confirm the transaction through your crypto wallet.

6. Next, we need to create an IPFS bucket on Filebase.

To do this, navigate to If you don’t have an account already, sign up, then log in.

7. Select ‘Buckets’ from the left sidebar menu, or navigate to.

Select ‘Create Bucket’ in the top right corner to create a new bucket for your NFTs.

8. Enter a bucket name and choose the IPFS storage network to create the bucket.

Bucket names must be unique across all Filebase users, be between 3 and 63 characters long, and can contain only lowercase characters, numbers, and dashes.

9. Now, upload your NFTs to Filebase using the web console and selecting ‘Folder’, then select the folder that contains your NFT files.

These files need to be named in sequential order, such as 0.png, 1.png, 2.png, etc.

10. You will see your folder uploaded as a single object:

11. Copy the CID of your folder:

12. Navigate to your IPFS Folder using the Filebase IPFS gateway to see your folder’s files:

Take note of this URL.

13. Head back to the thirdweb dashboard, where you will see the page for your NFT collection.

Select the ‘Code’ tab. This code showcases different code snippets to use to mint your NFTs using scripts, with your contract address and crypto wallet address inputted automatically for easy copy and paste. This tutorial will showcase the JavaScript code examples, but you can use any of the languages showcased in this Code tab. You can follow along with the code examples showcased in this tutorial, or copy and paste the snippets provided in this tab.

14. Open a command line window and install the thirdweb SDK:

npm install @thirdweb-dev/sdk

15. Open an IDE such as VSCode and insert the following code, replacing the following values:

  • CONTRACT with your contract address.

  • WALLET_ADDRESS with your crypto wallet address.

  • Each IPFS_CID with your IPFS folder CID you took note of earlier.

  • Replace the name and description of each NFT with your desired information.

import { ThirdwebSDK } from "@thirdweb-dev/sdk";

const sdk = new ThirdwebSDK("mumbai");
const contract = sdk.getContract("CONTRACT", "nft-collection");

// Address of the wallet you want to mint the NFT to
const walletAddress = "WALLET_ADDRESS";

// Custom metadata of the NFTs you want to mint.
const metadatas = [{
  name: "Cool NFT #1",
  description: "This is a cool NFT",
  image: fs.readFileSync(""), // This can be an image url or file
}, {
  name: "Cool NFT #2",
  description: "This is a cool NFT",
  image: fs.readFileSync(""),

const tx = await contract.mintBatchTo(walletAddress, metadatas);
const receipt = tx[0].receipt; // same transaction receipt for all minted NFTs
const firstTokenId = tx[0].id; // token id of the first minted NFT
const firstNFT = await tx[0].data(); // (optional) fetch details of the first minted NFT

You can edit this script to include as many NFTs as you’d like to mint at one time.

16. Save this script as mint.js, then run this script with the command:

node mint.js

17. Refresh your thirdweb dashboard. Your NFTs will be listed.

18. Navigate to the thirdweb Dashboard, then select ‘Deploy New Contract’:

19. From the 'Marketplace' options, select ‘Marketplace’.

Then select 'Deploy Now'.

20. Give your marketplace a name, description, and image to use as an icon.

Then select the network you’d like to deploy your marketplace on. This tutorial will use the Polygon Mumbai testnet.

Then select 'Deploy Now'.

21. After confirming the transaction through your crypto wallet, you’ll see your NFT marketplace’s dashboard. Select ‘Listings', then 'New Listing'.

22. Select the NFT you’d like to list for sale, then set a sale price for your NFT to be purchased.

23. Select ‘Create Listing’ to add your NFT to your marketplace.

You will be prompted to authorize 2 transactions through your crypto wallet.

24. Repeat this process to list all the NFTs in your collection.

25. Select the ‘Embedded’ tab. Edit any of the visual settings to match your intended configuration.

Then select ‘Copy to Clipboard’ to copy your embedded NFT marketplace widget code, which you can insert to any webpage to put your marketplace live so your NFTs can be purchased by others!

If you have any questions, please join our Discord server, or send us an email at

Last updated