Encyclopedia Ethereum · Entry 253
NFTs and IPFS: a content address is not a storage guarantee
In this article
At a glance
Key facts
| Fact | Detail | Source |
|---|---|---|
| Content identity | A CID identifies content within a specified encoding and structure. | [1] |
| Availability | Pinning protects retained data from a node’s garbage collection. | [2] |
| Pointer | An ERC-721 metadata URI can refer to offchain content. | [3] |
An identifier is not a storage contract
Content addressing lets software verify that retrieved data corresponds to the requested identifier. It does not create an obligation for every node to store that data. If no reachable provider retains it, retrieval can fail.
Different chunking, codecs or directory layouts can produce different CIDs for representations of the same apparent file. Avoid treating the CID as a universal hash of the original file bytes.
Metadata and the image may have separate dependencies
Suppose an NFT points to an IPFS metadata file whose image field points to another IPFS object. Keeping only the metadata accessible does not establish that the separate image is retained. Check both references and the pinning arrangement.
A gateway failure can also prevent one browser path from loading data that other providers still have. Distinguish one inaccessible gateway from proven loss of every copy.
Inspect who keeps the data available
Pinning can be local or handled by a remote service. A recursive pin retains referenced children in that object’s data structure, but unrelated URLs inside a metadata document need their own handling. Check the actual retention setup rather than rely on the word IPFS.
Finally, immutable content at one CID does not automatically make the NFT’s pointer immutable. The collection contract determines whether token metadata references can later change.
Direct answers
Questions people ask
Does minting an NFT automatically pin its image?
No. Token creation and storage retention are separate operations. A project must arrange for the referenced content to remain available.
Can I rely on one working gateway as proof of permanent storage?
No. It demonstrates current retrieval through that route. Long-term availability depends on retained copies and reachable providers.
Inspect the evidence
The answer and key facts have stable claim links. These records retain the scope and qualification when reused.
IPFS content identifiers identify content addressed data, but do not guarantee that a reachable node will retain and serve it forever. An NFT can reference IPFS metadata or media while its ownership stays on Ethereum. Check the token’s actual URI, whether the referenced data is pinned and whether the contract can change that URI; these are different durability questions.
Scope: Ethereum · data through 2026-10-02. Verification: verified · 2026-10-02T19:27:58.939Z.
Link to this claimContent identity: A CID identifies content within a specified encoding and structure.
Scope: Ethereum · data through 2026-10-02. Verification: verified · 2026-10-02T19:27:58.939Z.
Link to this claimAvailability: Pinning protects retained data from a node’s garbage collection.
Scope: Ethereum · data through 2026-10-02. Verification: verified · 2026-10-02T19:27:58.939Z.
Link to this claimPointer: An ERC-721 metadata URI can refer to offchain content.
Scope: Ethereum · data through 2026-10-02. Verification: verified · 2026-10-02T19:27:58.939Z.
Link to this claimRevision history
- — First publication after primary-source research and separate automated verification.
Source register
Sources and references
Retrieval dates and locators are recorded individually.- IPFS content addressingIPFS contributors
A CID identifies content rather than promising a continuously available server.
Locator: Content identifiers; content addressing · Version / scope: Documentation snapshot retrieved 2 October 2026; response hash recorded separately · Retrieved: 2026-10-02T18:55:25.788ZOpen source - IPFS persistence and pinningIPFS contributors
Availability depends on nodes retaining and serving content; pinning prevents local garbage collection.
Locator: Pinning; garbage collection; remote pinning · Version / scope: Documentation snapshot retrieved 2 October 2026; response hash recorded separately · Retrieved: 2026-10-02T18:55:25.704ZOpen source - ERC-721 NFT standardEthereum Improvement Proposals
Ownership, receiver checks, token-level and operator approvals, mint/burn event semantics.
Locator: safeTransferFrom; approve; setApprovalForAll; Transfer; metadata · Version / scope: ERC-721 · Retrieved: 2026-10-02T18:55:25.399ZOpen source
Research and drafting use AI assistance. A separate automated review checks claims against primary sources; no external expert or named human review is implied. Publication, substantive editing, source retrieval and verification are recorded separately. This version was independently checked by an automated reviewer on 2 October 2026.
Editorial method and correctionsDegrees of Satoshi editorial project. “NFTs and IPFS: a content address is not a storage guarantee.” Published 2026-10-02; updated 2026-10-02. https://degreesofsatoshi.com/encyclopedia/nft-ipfs-storage/