Skip to content

Commit cee649b

Browse files
authored
fix: clarify docs when status is pinning (#2343)
1 parent 6dad78d commit cee649b

1 file changed

Lines changed: 6 additions & 2 deletions

File tree

packages/website/pages/docs/how-to/get-status.md

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -14,13 +14,17 @@ The information in the file listing page is also available using the [JavaScript
1414

1515
## Archived?
1616

17-
When you upload data to NFT.Storage, there might be some situations when an upload did not successfully complete. If you intended to upload a file, the **Archived?** column shows whether we received a complete graph of data. There are four possible values for the column: 📌, `Queuing`, `Pinned`, and `Failed`.
17+
When you upload data to NFT.Storage, there might be some situations when an upload did not successfully complete. If you intended to upload a file, the **Archived?** column shows whether we received a complete graph of data. There are five possible values for the column: 📌, `Pinning`, `Pinned`, and `Failed`.
1818

1919
📌 status means that we have received a complete graph of data.
2020

2121
A `Pinned` status is a legacy status from our previous architecture. It is equivalent to the `Complete` status.
2222

23-
The `Queuing` status indicates that the completeness of the graph of data is still being validated.
23+
The `Pinning` status indicates that the completeness of the graph of data is still being validated.
24+
25+
<Callout emoji="!">
26+
**If you have a large upload with many blocks (e.g., a directory for your 10K NFT drop), currently NFT.Storage might report the status as `Pinning` indefinitely. This is because the upload was too large for us to validate that the upload is a complete graph. You can verify that your upload is complete by spot checking individual files in your upload and making sure they're available via nftstorage.link.**
27+
</Callout>
2428

2529
A `Failed` status indicates that the graph of data is incomplete. For older uploads, it can also mean an operation failed while our infrastructure was attempting to pin the data. A `Failed` pin will change to `Pinned` if the same data is uploaded successfully in a subsequent request. As long as the CID is the same for both uploads, the original upload's status will be marked as `Pinned` after a small delay.
2630

0 commit comments

Comments
 (0)