Magic Eden provides a feature that lets you attach multiple images or GIFs to a single NFT. This help center article walks you through the steps to activate this feature by updating the metadata of your tokens.
As a practical example, we'll be using the Claynosaurz collection to illustrate how this works.
What you'll achieve
By the end of this guide, you'll learn how to enable toggling between different images or GIFs associated with your NFT on Magic Eden.
Understanding metadata with Claynosaurs
Before diving in, it's crucial to understand how the metadata of a token looks. Here is an example metadata for a Claynosaurz token:
{
"name": "Claynosaurz #7261",
"symbol": "DINO",
"description": "Claynosaurz is a collection of 10,000 3D animated NFTs...",
"seller_fee_basis_points": 500,
"image": "https://nftstorage.link/ipfs/bafybeihvjei4fli5ix7nzahibh5ootq27hjzuqymwjvyewbt57l3crruy4/7260.gif",
"external_url": "https://twitter.com/Claynosaurz",
"attributes": [...],
"properties": {
"creators": [...],
"files": [
{
"uri": "https://nftstorage.link/ipfs/bafybeihvjei4fli5ix7nzahibh5ootq27hjzuqymwjvyewbt57l3crruy4/7260.gif",
"type": "image/gif"
},
{
"uri": "https://nftstorage.link/ipfs/bafybeig7axxb3irpjnb5l7gmizilwp67pe7hq4adz2fh7p552hmpwcn67e/7260.png",
"type": "image/png"
}
],
"category": "image"
}
}
Identifying key metadata fields
Primary image field
In the metadata, the "image" field defines the primary image that will be displayed when toggling is off:
"image": "https://nftstorage.link/ipfs/bafybeihvjei4fli5ix7nzahibh5ootq27hjzuqymwjvyewbt57l3crruy4/7260.gif"
Additional files section
The "files"
field under "properties"
holds the additional images you want to associate with the NFT. This is where you can include images that can be toggled:
"files": [
{
"uri": "https://nftstorage.link/ipfs/bafybeihvjei4fli5ix7nzahibh5ootq27hjzuqymwjvyewbt57l3crruy4/7260.gif",
"type": "image/gif"
},
{
"uri": "https://nftstorage.link/ipfs/bafybeig7axxb3irpjnb5l7gmizilwp67pe7hq4adz2fh7p552hmpwcn67e/7260.png",
"type": "image/png"
}
]
Setting up your own metadata
To enable the image toggling feature for your own NFTs, make sure you follow a similar metadata structure. It's crucial to specify the image type (e.g., "image/png"
or "image/gif"
).
Activating image toggling
Once you've set up your metadata to include multiple images, reach out to the Magic Eden support team for activation. Open a chat using the widget on the website.
The Magic Eden support team will enable the feature that allows you to toggle between the different images or GIFs associated with your NFT.