Upload Assets and Metadata

Upload Options

Storage Note: Creators are required to maintain their own storage for NFT links. There are numerous popular options including Pinata and Arweave. Creators are encouraged to compare options and think long term about which storage provider fits best for their long term goals.

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 from a storage provider

• Upload your files manually to an IPFS hosting provider, then launch the collection in studio using the base URI link for those files or folders

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 Pinata using an API key.

Obtain an API Key

The API key for your collecton may be attained on Pinata.

After you obtain the API key and your secret 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.

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.

A pop-up will appear and you'll be able doublecheck and update the metadata if needed.

If you have successfully uploaded assets and metadata, you can skip the rest of this page.

2) Use an Existing Base URI

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 and Arweave.

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

Providing a different folder structure for your NFT collection can cause unexpected behavior.