Upload Assets and Metadata

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 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:

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 and web3.storage using your email address.

Obtain an API Key

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.

Asset Selection

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"
}

Update Metadata

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.

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

If you choose to use an existing base URI and completed the steps above, you can proceed to the Configure Collection and Minting Detailsstep.