NiftyKit

Adding NFT Metadata on DropKit

DropKit offers the ability to batch upload your artwork a few different ways:

  1. REST API endpoint
  2. Copy and Paste metadata directly in NiftyKit app
  3. Google Sheets Export

REST API endpoint

Each individual collection has a unique API key that allows you to submit your metadata via API. 

You can access the API in the 3-dot drawer and copy your API key.

Using your API key, submit a POST request with the data to this endpoint.

POST https://app.niftykit.com/api/drops/tokens

You can reference the API documentation here.  

Copy and Paste metadata directly in NiftyKit app

In the same API window you will see a pre-populated template of .json data that you can use as reference to upload your NFTs in batches.

Each time you run a request, it appends the data and creates a new NFT.

Metadata Structure

Drops are configured using the following standards from Opensea.

Below is an example for creating 2 NFTs, one with an attribute of color.

Once you paste your data into the box, it will add on 2 NFTs.

Multiple NFT Metadata

				
					{
  data: [
    {
      description: 'This is an example #1',
      name: 'NFT Example #1',
      attributes: [
        {
          trait_type: 'color',
          value: 'red'
        }
      ],
      image: 'https://ipfs.io/ipfs/QmVsy5Uq8CuA7GPoyJFpsNQoDiC1csdJVEJU7SoveUAmzp',
      animation_url: '',
      background_color: '',
      youtube_url: '',
      external_url: ''
    },
    {
      description: 'This is an example #2',
      name: 'NFT Example #2',
      attributes: [],
      image: 'https://ipfs.io/ipfs/QmVsy5Uq8CuA7GPoyJFpsNQoDiC1csdJVEJU7SoveUAmzp',
      animation_url: '',
      background_color: '',
      youtube_url: '',
      external_url: ''
    }
  ]
}
				
			

Single NFT Metadata

				
					{
  data: [
    {
      description: 'This is an example #1',
      name: 'NFT Example #1',
      attributes: [
        {
          trait_type: 'color',
          value: 'red'
        }
      ],
      image: 'https://ipfs.io/ipfs/QmVsy5Uq8CuA7GPoyJFpsNQoDiC1csdJVEJU7SoveUAmzp',
      animation_url: '',
      background_color: '',
      youtube_url: '',
      external_url: ''
    }
  ]
}
				
			

Thumbnail Image Preview For Video NFTs

In order for video NFTs to show up correctly on Opensea you will need to configure the NFTs using the API.

You will need a separate image to set for the thumbnail for the video.

There are 2 important fields to note:

  1. animation_url
  2. image
{
name: "Sample NFT Title #1",
description: "Learn how to set up videos in DropKit",
animation_url: "https://ipfs.io/ipfs/QmSqyFafQPH9KAhyMzUdTqBHfm9pAqrUkAEsgxhbsQSXbg",
image: "https://ipfs.io/ipfs/Qmeam2afLjPRWuieHTYS6dBAwUosG1iYYE531JM9LYJfHU"
}

Animation URL

A URL to the video for the NFT. The file extensions GLTF, GLB, WEBM, MP4, M4V, OGV, and OGG are supported, along with the audio-only extensions MP3, WAV, and OGA.

Image

This is the URL to the image of the item. Can be just about any type of image (including SVGs, which will be cached into PNGs by OpenSea, and even MP4s)

We recommend using IPFS URLs or paths.

Opensea recommends using a 350 x 350 image for the best results.

Google Sheets Exporter

To set up your metadata using Google Sheets:

  1. Copy Example Google Sheet
  2. Add NFTs on each line by order of minting
  3. Click Export JSON
  4. Copy Generated JSON
  5. Paste in DropKit API window
  6. Run Request to add your NFTs to DropKit
Copy Google Sheets to get started: 
Generated from your google sheets list
Click on Export JSON. May need to authorize script to run.
Paste JSON in the API Key Window

Updating NFT Metadata

Metadata, images, and the order of your NFTs can be changed before, during, and after a drop by clicking Update Metadata in the 3-dot drawer menu in your dashboard.

Updating your metadata is done through your smart contract, so you will be required to pay gas each time you push metadata changes.

This action is updating the URI for your metadata and is the mechanism that will allow you to do the NFT reveal type drops.

The ability to change the metadata will allow you to:

  • Fix any broken attributes or properties after the NFT has been minted
  • Change the name of the NFT
  • Update the image creative for the NFT
  • Reorder and reassign NFTs by token ID number

It’s important to understand that changes are not reflected on Opensea until you click the Update Metadata button.

Refresh Metadata on Opensea

It may take some time for Opensea to fully update the metadata, so plan for this in your drop.

You can force the metadata to refresh on Opensea like this: 

Freezing Metadata

If you want to remove yourself and ensure that collectors know you aren’t able to change the metadata anymore, you could click the Renounce Ownership option, and this will remove the power for anyone to run admin functions on your contract. This essentially locks the contract for further changes, but still allows your NFTs to be openly traded, sold, and purchased on the secondary market. 

Join Us On Discord To Get Help

By clicking Accept, you agree and consent to NiftyKit's Terms of Use & Privacy Policy