Frequently Asked Questions

Frequently
Asked
Questions
What is meant by the "web3.storage platform"?
web3.storage is a suite of APIs and services that make it easy for developers and other users to interact with data in a way that is not tied to where the data is actually physically stored. It natively uses decentralized data and identity protocols like IPFS, Filecoin, and UCAN that enable verifiable, data- and user-centric application architectures and workflows.

At the core of the platform includes a hosted storage service which can be used to upload and persist data to make it continuously available. The platform also contains additional services like w3link and w3name that make it easier to create seamless, delightful web experiences utilizing web3 protocols.
What advantages does web3.storage have over traditional hosted storage services?
Because web3.storage uses decentralized data and identity protocols like IPFS and UCAN, data and identity are referenced in an open way. Data is referenced using IPFS content identifiers that are unique to the data, making your data completely portable - accessible from anywhere broadcasting data to the IPFS network, whether on a local or peer device, or uploaded to web3.storage itself. Data is backed up on Filecoin, which gives cryptographic proof that your data is physically being stored without needing to trust web3.storage.

Authentication is associated with user decentralized identifiers (DIDs) that sign UCAN tokens that can be cryptographically verified by the web3.storage service, meaning that your identity is not determined by a central authentication server. And because any storage solution can utilize the same UCAN and IPFS content IDs, there is no lock-in to web3.storage’s service.
What advantages does web3.storage have over other IPFS hosted services?
web3.storage runs on Elastic IPFS, an open-source, cloud-native, highly scalable implementation of IPFS. We wrote it as the solution to address increasing adoption of web3.storage, which previously used kubo and IPFS Cluster. As a result, web3.storage is designed to give strong performance and reliability regardless of how much data is being stored on it, meaning that you can rely on it as you and web3.storage grow. And all data is backed up in Filecoin storage deals, which gives cryptographic proof that your data is physically being stored without needing to trust web3.storage.

Further, the platform provides other best-in-class implementations of IPFS on performant infrastructure, from w3link, our IPFS HTTP gateway that can be up to 10x faster than other public gateways, to w3name, a hosted service for dynamic data use cases.
How do I store data on web3.storage that is already available over the IPFS network without having to download and reupload it myself?
Paid web3.storage plans give users access to our implementation of the Pinning Service API, which allows you to store data on web3.storage that is already available over the IPFS network.
What is the relationship between NFT.Storage and web3.storage?
web3.storage is a platform that enables developers, applications, and users to interact with data independently of where it is stored, using decentralized protocols like IPFS and UCAN. This includes an easy-to-use, performant storage service that makes data available on IPFS and persists it on the Filecoin decentralized storage network. NFT.Storage is a service whose mission is to perpetually store all off-chain NFT data as a public good (so for free, forever). It currently runs on the web3.storage platform today, but has future plans to provide its services in a fully decentralized manner (run by a DAO with operations and governance instrumented on smart contracts).
How can I delete items from Web3.Storage?
You can delete files listed in your account. Simply log-in to your account and use the file manager on the files page. It's currently not possible to delete files via the API or the client libraries.

However, once a file is uploaded to web3.storage, there cannot be a guarantee that all copies of the file are gone from the IPFS network. As soon as a file is uploaded, other IPFS nodes can access and store a copy of the data. The data only becomes unavailable when the last IPFS node has stopped pinning the file, and all copies are garbage collected. As a consequence you should only upload to web3.storage files that you know can be shared with anyone forever, or are securely encrypted.

We are in the process of rolling out a new client and service called w3up that programmatically allows you to unlink uploads from being associated with your account. The Alpha version CLI can be found here and the client here. Later, the current Javascript client will use w3up and all existing uploads and accounts will be migrated to the new service.
Can I use Web3.Storage, even if I don't want to use the Javascript or go client libraries?
Yes, you can use the Web3.Storage APIs directly, but in that case you need to ensure that you provide the API with the right format. The API won't accept raw files above 100MB, so you'll need to package them as .CAR files and chunk them to the right size using CLI tools like ipfs-car and carbites.
How can I edit a file or add files to a folder?
Since CIDs are immutable, it's not possible to edit files or add files to a folder. We recommend checking out w3name, our hosted IPNS service, if you are interested in dynamic data.
How can my users upload files directly to Web3.Storage without them needing to create their own account?
The current Javascript client and API requires you to provide the API token in your front-end, allowing anyone to upload files to your account and list already uploaded files. However, we are in the process of rolling out a new client and service called w3up that natively uses UCAN for authentication, meaning you can cryptographically delegate permission to other actors to directly upload to your account. The Alpha version CLI can be found here and the client here. Later, the current Javascript client will use w3up and all existing uploads and accounts will be migrated to the new service.