Removing data from your account

You might want to remove data from being associated with your account. You can do so using the JS client, CLI, or web console.

Note that there is a minimum 30 day retention period for uploaded data, and even once removed, the data might persist on the public IPFS network.

Removing uploads (content CIDs) vs. stores (shard CIDs)

web3.storage tracks two different things for its users to support content addressing. These concepts were first introduced in the Upload section:

• Content CIDs: The CIDs used to reference and access uploads in the format generally useful to users (e.g., files, directories). These CIDs are usually prefixed by bafy… or bafk….
• Shard CIDs: The CID of the serialized shards of data itself (CAR files) that are produced client-side, sent to web3.storage, and stored. These CIDs are prefixed by bag….

web3.storage tracks usage for payment (i.e., how much storage is utilized by a user) using the volume of data associated with shard CIDs. However, in general, most users will be interacting with content CIDs (this is how you fetch your data from the network), with shard CIDs more of an implementation detail (how data gets chunked, serialized into CAR files, and stored for uploads).

Fortunately, this shouldn't make things any more complicated - we go into more detail below, but in general, when you remove a content CID from your account, you'll want to remove the shard CIDs as well (e.g., in the client calling client.remove(contentCID, { shards: true })).

However, if you are a power user interacting with shard CIDs as well (e.g., using the client's capability.store.* or CLI's w3 can store * methods), then you need to be more cautious about removing shard CIDs from your account. (This is why the default for the client and CLI methods is for shards to be maintained after removing a content CID). You can read more about why you might want to interact with shard CIDs directly and the implications in the Upload vs. Store section.

Using the JS client or CLI

If you followed the Upload section, you should already have your client or CLI set up with an Agent for your Space. From there, to remove a content CID from your account, you'll generally be using:

• Client: client.remove(contentCID)
• CLI: w3 rm <contentCID>

If you initially uploaded your content by using the recommended upload methods (e.g., used Client.upload() or w3 up) and didn't interact with CAR shards at all when uploading, we recommend removing the shard CIDs associated with the content CID from your account. Otherwise, you will still be paying for the data stored with web3.storage (as mentioned above). The easiest way to do that is to set the shards option to true:

• Client: client.remove(contentCID, { shards: true })
• CLI: w3 rm <contentCID> --shards

Removing content CIDs and shard CIDs separately

If you have managed your shard CIDs and upload CIDs separately (e.g., used client.capability.store.add() and client.capability.upload.add() in the client or w3 can store add and w3 can upload add in the CLI), you might want to remove the upload CIDs and underlying shard CIDs separately as well. You can read more about why you might want to interact with shard CIDs directly and the implications in the Upload vs. Store section.

To remove shard CIDs and upload CIDs separately, you'll generally do this by:

1. Determine shards to remove (skip this step if you already know!):
   • Client: client.capability.upload.list(contentCID)
   • CLI: w3 can upload ls <contentCID> --shards
2. Remove the upload:
   • Client: client.capability.upload.remove(contentCID)
   • CLI: w3 can upload rm <contentCID>
3. Remove each of the shards (ensure first that no other content is using that shard!):
   • Client: client.capability.store.remove(shardCID)
   • CLI: w3 can store rm <shardCID>