The files page is center of the Pinata App where you can upload files, manage them, and view them through a Dedicated Gateway.
Add Files
Uploading files is simple, just click on the "Add Files" button in the top right, select if its a folder or a file you want to upload, select the content, give it a name, then upload!
When you upload a file this way, Pinata automatically pins the content to IPFS. After pinning to IPFS you will see a CID that is used to access the content across the IPFS network, and the CID is typically used in mediums such as NFTs. Read more about NFTs hereor how how IPFS works here.
Files uploaded to Pinata are Pinned to IPFS and can be publicly accessed!
Pin by CID
Another option for uploading files is pinning something that is already on IPFS. This can be content from another IPFS pinning service or from your own local IPFS node.
To pin content this way, click on the "Add Files" button in the top right, select "CID," then paste in the CID and the name you want to use, then click "Search and Pin." After doing this it will be added to a queue where Pinata will start looking for the content.
While in the Pin By CID queue there are several possible statuses:
| Status | Description |
|---|---|
| Prechecking | Pinata is prechecking the CID before searching, making sure it's a valid CID. e.g. if you put in random words instead of a valid CID it would fail the prechecking |
| Searching | Pinata is currently looking for the CID content on IPFS. If your pin job is stuck in the searching status, that usually means we can't find the CID and the file is not available on IPFS. |
| Retrieving | Pinata has found the CID and is currently pinning the content to Pinata IPFS nodes. Be aware that the speed might vary on the number of files and the IPFS network. Pinning by CID can take anywhere from a few minutes to a whole day. |
| Expired | Pinata was in the middle of retrieving the files, but there was an interruption in the connection. |
| over_max_size | Pinata identified the file/folder as being over the 25GB upload limit. The Pinata team can help with special cases that go over this limit, but we cannot guarantee success. Please email [email protected] for assistance. |
If you are trying to upload through a local IPFS node we would recommend using this guide.
Upload Limits
Keep in mind that Pinata has a 25GB limit on individual files or folders when uploading through the Pinata App. For more info please visit the Limits Page.
Viewing Files
To view your file, you can click on the "eye" icon which will either open the file through your Dedicated Gateway.
Sharing Files
If you want to share a file you can simply click on the "Share" button from the Files view. You will be given a pin.ski link that you can share to others.
Setting Gateway Root
A unique feature on Dedicated Gateways is the ability to set a file as the gateway root. It's a simple redirect of a gateway root url to a specific CID you have designated. For instance, if you visit https://pinata-media.mypinata.cloud you would be redirected to https://pinata-media.mypinata.cloud/ipfs/QmVLwvmGehsrNEvhcCnnsw5RQNseohgEkFNN1848zNzdng. This is create for websites hosted on Pinata or smaller projects (like this cool photo zine).
To set a file as the gateway root, simply click on "more" for the desired file, then click "Set as gateway root."
Deleting Files
Deleting files from Pinata only unpins them from Pinata's IPFS nodes. If the file is pinned elsewhere or with another service, it will remain on IPFS.
If you want to delete any files you have uploaded, you can click on the "More" button and select "Delete File."
We are currently working on a bulk-unpin feature in the Pinata App. In the meantime you can use this script to unpin a large selection of files.
Updated 20 days ago