Skip to main content

Upload to IPFS

Releasing the collection at Scatter you have two options to upload your art and metadata to IPFS. You can use our Content uploader or NFT.storage app.

Content Uploader Instructions​

Here at Scatter, we want it to be as easy as possible to launch your NFT Collection, to that end, we have created an uploader.

Here's how to go from brain to chain:

1. Create the Collection on Scatter​

Create a collection on Scatter and leave baseURI blank.

2. Gather Your Files​

Just gather your art/metadata and zip it up in one file.

  • Images MUST be named "1.png", "2.png", "3.png", etc
  • We support many formats of images, such as png, jpg, glb, vrm, mp4 and mp3
  • Metadata MUST be named numerically "1", "2", "3", etc (or "1.json", "2.json", "3.json", etc)
  • If you need metadata you can generate some using our webtools or the uploader
  • Metadata only needs to have a name, description, and an (optional) project link. The uploader app will fill in the links for the images and such for you.

3. Start Upload Process​

Go to https://uploader.scatter.art/ and upload your ZIP.

  • Due to the potential large size of your image files, which could be several gigabytes, or a slow internet connection, uploads might take a considerable amount of time. To prevent any disruptions, ensure that your computer's screensaver and automatic sleep mode are disabled; otherwise, the upload could be interrupted and fail.
  • After upload you can return to the previous screen and add more files if needed

4. Validate Your Metadata​

Verify everything looks good and the tests all complete on the left-hand side, then press continue.

5. Select Storage​

Here you can select storage, you can choose from two options: Instareveal and NFT.Storage.

  • NFT.storage: Follow the on-screen directions to get an API Key from NFT.Storage and paste it in, then press continue
  • Instareveal: Ask us for a key in a support ticket. Copy/paste the contract address and the API Key in, then press continue
  • Instareveal has the benefit of "revealing" your nft's as they mint - preventing anyone from snooping on which items in your collection haven't minted yet

6. Set baseURI​

After waiting for the last page you should receive a baseURI.

Go back to your collection page on Scatter -> edit collection (pencil icon) -> Contract methods -> setBaseURI -> paste in the baseURI -> All done! Just let us know so we can refresh you on OpenSea and Scatter.

  • If it's still "loading" your baseURI, please click "open menu", wait 10 minutes and refresh. You should now see baseURI at the top of your screen. If you still don’t, please repeat one more time and then contact us in a support ticket.
  • If you've set the baseURI to your collection before and want to update it (fixed some mistakes, for example), please open a ticket in Scatter Discord and ask us for refresh after you do this. Otherwise you may still see old images and metadata at Scatter or other marketplaces. We will initiate the refresh for both Scatter and OpenSea, other marketplaces usually follow it, but sometimes it may be an issue with Blur. There are no programmatic way for us to refresh at Blur yet, so if you face this issue, please ask Blur support in its Discord.

NFT.storage Instructions​

1. Get an API Key​

First of all, sign up/login with your e-mail https://nft.storage/login/ and get your API key on your account page.

  • You can use a web-version, but we highly recommend you to install a desktop app. Using a web-version you are able to upload your files one by one only, while using an app you are able to bulk upload all your files at once.
  • Launch an app, now you can drag and drop some files on it. You will be prompted for your API key. Paste it, it's a one-time action.

2. Upload Your Images​

Now you will upload your collection images:

  • Images MUST be named "1.png", "2.png", "3.png", etc
  • We support many formats of images, such as png, jpg, glb, vrm, mp4 and mp3
  • DON'T upload a .zip or a folder with your images. Select all images inside the folder and then drag and drop it to the app.
  • Once the upload is finished, you'll get a CID of your images folder on IPFS. This CID will be used at the step 3.

3. Edit Your Metadata​

Edit your metadata image links and put a CID of your images in all json files:

"image": "ipfs://CID/1.png"

"image": "ipfs://CID/2.png"

"image": "ipfs://CID/3.png"

etc.

You can use this tool to easily update image fields in metadata.

4. Upload Your Metadata​

Now you will upload your metadata files:

  • Metadata MUST be named "1", "2", "3", etc
  • Metadata MUST be without .json extensions. You can use this tool to remove it.
  • If you need metadata you can generate some using our webtools or the uploader
  • Metadata only needs to have a name, description, image link and an (optional) project link
  • DON'T upload a .zip or a folder with your metadata. Select all metadata files inside the folder and then drag and drop it to the app.
  • Once the upload is finished, you'll get a CID of your metadata folder on IPFS. This CID will be used at the step 5.

5. Set baseURI​

Create a collection on Scatter, fill all the fields and paste in the baseURI using the format ipfs://CID/.

If you've already created the collection before, just go to your collection page on Scatter -> edit collection (pencil icon) -> Contract methods -> setBaseURI -> paste in the baseURI using the format ipfs://CID/ -> All done! Just let us know so we can refresh you on OpenSea and Scatter.

  • You must use a CID of your metadata folder, not of your images folder
  • If you've set the baseURI to your collection before and want to update it (fixed some mistakes, for example), please open a ticket in Scatter Discord and ask us for refresh after you do this. Otherwise you may still see old images and metadata at Scatter or other marketplaces. We will initiate the refresh for both Scatter and OpenSea, other marketplaces usually follow it, but sometimes it may be an issue with Blur. There are no programmatic way for us to refresh at Blur yet, so if you face this issue, please ask Blur support in its Discord.