Upload Assets and Metadata
This page covers some of the Studio's features and its rules to upload a collection.
PreviousCreating an Open/Limited Edition CollectionNextConfigure Collection and Minting Details: OE/LE
Last updated
This page covers some of the Studio's features and its rules to upload a collection.
Last updated
There are two ways to provide your collection files to Stargaze Studio.
You can either
Upload assets & metadata through Stargaze Studio by providing an API key or email address linked with a web3.storage account
Use an existing base URI after uploading your files manually to an IPFS hosting provider
Either way, you must follow some naming rules:
First of all, to upload assets and metadata, an API key to store your collection must be provided. Stargaze Studio currently supports Pinata using an API key and web3.storage using your email address.
Refer to Pinata Upload to learn how to obtain an API key to store your collection. You may also use an email associated with a web3.storage account.
After you obtain the API key and your secret key, simply paste it and proceed to the asset selection part.
Now is the time to upload your asset, you can either upload using Choose Files button or simply by dragging and dropping to the asset selection area.
Metadata Selection
After you upload the assets, a metadata selection box will appear as seen in the image above. There you can upload the metadata for your collection in JSON format.
Here is the example metadata file designed for the open edition token:
{
"attributes": [
{
"trait_type": "Head",
"value": "Kangaroo"
},
{
"trait_type": "Clothes",
"value": "Spacesuit"
},
{
"trait_type": "Personality",
"value": "Determined"
},
{
"trait_type": "Background",
"value": "Space"
}
],
"description": "A kangaroo in space.",
"external_url": "https://example.com/?token_id=1",
"name": "Space Kangaroo"
}Stargaze Studio lets you update the metadata through the interface. Simply click on one of your assets after uploading the metadata files. For Open/Limited Edition collections based on a single asset, many users will fine it easier to simply add their metadata through Studio UI.
If you have successfully uploaded assets and metadata, you can skip the rest of this page and proceed to the Configure Collection and Minting Details page.
There are many storage providers where you can upload assets to IPFS and obstain a base URI link to use in Stargase Studio. Some options are Pinata, web3 Storage, and Filebase.
If you have already uploaded your assets and metadata to IPFS or you want to handle it manually, first make sure that the folder structure is as follows:
Project Folder:
- images
- 1.png
- 2.png
- 3.png
- metadata
- 1.json
- 2.json
- 3.jsonProviding a different folder structure for your NFT collection can cause unexpected behavior.
If you choose to use an existing base URI and completed the steps above, you can proceed to the Configure Collection and Minting Detailsstep.