Upload Assets and Metadata

This page covers some of the Studio's features and its rules to upload a collection.

Upload Options

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

• Use an existing base URI by uploading your files manually

Either way, you must follow some naming rules:

Asset and metadata names must be in numerical order starting from 1 and must only be consisted of numbers. Symbols or letters are not allowed.

This rule also applies to the metadata (JSON) files.

Valid

• 1.png

• 2.png

Invalid

• 1-punk.png

• 2-punk.png

You must upload a corresponding JSON file containing the metadata for each asset and the names of the asset and metadata files must match.

Valid

images

• 1.png

metadata

• 1.json

Invalid

images

• 1.png

• 2.png

metadata

• 1.json

1) Upload Assets and Metadata using Stargaze Studio (Recommended)

First of all, to upload assets and metadata, an API key to store your collection must be provided. Stargaze Studio currently supports NFT.Storage and Pinata.

Obtain an API Key

Refer to NFT.storage (script) or Pinata Upload to learn how to obtain an API key to store your collection.

After you obtain the API key, simply paste it and proceed to the asset selection part.

Asset Selection

Now is the time to upload your assets, you can either upload using Choose Files button or simply by dragging and dropping to the asset selection area.

Supported asset formats are

Image: JPG, PNG, SVG, and GIF.

Audio: MP3 and WAV.

Video: MP4.

After uploading assets

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 first token in the collection used in this guide:

{
  "attributes": [
    {
      "trait_type": "hat",
      "value": "bandana"
    },
    {
      "trait_type": "glasses",
      "value": "sunglasses"
    },
    {
      "trait_type": "personality",
      "value": "chill"
    },
    {
      "trait_type": "shirt_color",
      "value": "purple"
    },
    {
      "display_type": "number",
      "trait_type": "generation",
      "value": 1
    }
  ],
  "description": "Just some guy that likes to code_1.",
  "external_url": "https://example.com/?token_id=1",
  "name": "Shane Stargaze"
}

Notice that **** the image key value is missing, which is needed while uploading assets manually. However, Stargaze Studio handles it by using your API key and fills it automatically.

Update Metadata

Stargaze Studio lets you update the metadata through the interface. Simply click on one of your assets after uploading the metadata files.

Click on one of the assets to edit

A pop-up will appear and you'll be able to update the metadata

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.

2) Use an Existing Base URI

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.json

If you want to learn how to upload your files manually, have a look at the https://github.com/public-awesome/docs/blob/main/guides/readme/3.-add-assets-and-metadata section or use NFTUp to handle the upload.

Providing 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 Details step.