All Collections
Creating on SuperRare
How to prepare your metadata .CSV file for Releases
How to prepare your metadata .CSV file for Releases

A complete guide to preparing your assets and metadata for IPFS.

E
Written by Ed
Updated over a week ago

Introducing Releases, an exciting and novel feature on SuperRare designed to minimize gas fees for creators and streamline the art collection process for collectors. Before you begin with Releases, substantial preparatory steps are essential to guarantee a seamless minting experience. This guide will comprehensively walk you through each step.

Keep in mind that once you deploy the contract, the details/metadata become unchangeable/uneditable so it’s important that this is completed before you begin.


Let's get started! 🎉


Steps to prepare your metadata .CSV file

1. Get a decentralized hosting service: Find a hosting service to store and share your data in a distributed file system using IPFS or Arweave. We recommend https://www.pinata.cloud for their simple and easy to use UI. You’ll be using it to upload your asset files that you will need for the upcoming steps.

Sign up for a free account and follow their guide below.

2. Upload your assets to IPFS: Gather and prepare your images and media assets in a folder and upload it to the IPFS hosting service.

NOTE: For animated files like .mp4 or GLB, you will need to upload the image or gif you want to use as a thumbnail.

3. Create your metadata .CSV file: This will be your metadata file that you’ll use to upload for your Release Collection. You can make a copy or download the template below:

​Your columns must have:

  • name

  • description

  • image: URL of the image asset. The supported file types are GIF, png, and JPG.

💡TIP: You can grab the individual url for your images by clicking on your IPFS folder – it should look something like this:

https://green-faithful-bobcat 535.mypinata.cloud/ipfs/QmVAaVTHMgnLN59vkQDrnQvTaAk4UGUC9Fa3kgWqXvcWwe/Girl_w_theview1.png

  • media.asset // optional url of the media asset if it exists (MP4, glb).

NOTE: If you're uploading video or 3D files, this is where you input the url for those files. Importantly, you will need to also grab the IPFS URL for the thumbnails and input it in the image column.

  • media.dimensions // (ex: 1800x2400) optional dimensions of the asset if relevant, due to the simplicity of the tool, if dimensions are omitted, they will not be calculated.

  • For additional properties use the column for the name. i.e. Color if you want a color property. Note we will use the exact name provided in the column.​

4. Create and deploy your contract: It's time to create and deploy your contract for your collections! Select Release, enter the name of your contract, the contract symbol ticker and the total number of artworks your collection has. Submit and confirm the contract creation.

NOTE: It is important that all of your metadata details and assets are finalized as you will not be able to make any edits once the contract has been deployed.

5. Upload your metadata .CSV file to Release: You’re now ready to upload your metadata .CSV file to your Release! Select Prepare Metadata, and upload your .CSV file.

6. Complete your Release Details: Once the IPFS URL is generated, fill out the Release Details:

  • Price Per Token: Set the price for your artwork

  • Currency Type: For now this will be in ETH but in the RARE future...

  • Max Tokens Per Transaction: Set the number of artwork a buyer can mint per transaction. This allows a buyer to mint multiple artwork or just one.

  • Release Date: Set your date for your mint

  • Release Start Time: Set your start time for your mint​

Hit Submit! Congrats on your Release! 🎉

Add a Description to your Release

Here's how you can add a description to your Release. Grab your contract address from the URL of your Release page, and insert it to the http://superrare.com/series/INSERT YOUR CONTRACT ADDRESS. You will be taken to your Series page where you can edit the description as you normally do for your Series collection.

It should look like this:

Feeling lost or have questions? Reach out to [email protected]

Did this answer your question?