SWNFT
NFT Education

What Is IPFS and How Do NFTs Store Images?

Most NFTs don't store the image on-chain. Here's how IPFS works, what a CID is, why NFT pictures sometimes break, and how to check before you buy.

James Killick5 min read

TL;DR

  • Most NFTs store only a pointer on-chain. The actual image lives off-chain, often on IPFS.
  • IPFS finds files by their content, not their location. The file's fingerprint is called a CID.
  • If no one keeps a copy of the file (called pinning), the image can vanish even though the CID still exists.
  • Fully on-chain NFTs and Arweave-stored NFTs are more permanent but cost more to make.

Most NFTs do not store the image inside the token. The NFT on-chain usually holds a link or a hash that points to the picture, which lives somewhere else. That somewhere is often IPFS, a network that finds files by their content instead of their web address.

What does IPFS actually mean?

IPFS stands for InterPlanetary File System. It's a way to store and share files across many computers instead of one central server.

When you add a file to IPFS, the system runs it through a hash and gives it a unique fingerprint called a CID, short for Content Identifier. The CID is built from the file's contents. Change even one byte and the CID changes completely. That's why people call IPFS "content-addressed" storage.

So instead of asking "fetch the file at this web address," your wallet asks "fetch the file with this exact fingerprint." Any computer holding that file can serve it. This makes the system harder to censor and less tied to one company staying online.

How does an NFT actually use IPFS?

The flow is simple once you see it laid out:

  • The image is uploaded to IPFS and gets a CID.
  • A small metadata file (JSON) is uploaded too. It holds the name, description, and a link to the image CID.
  • The metadata link goes into the NFT smart contract.
  • Your wallet or marketplace reads that on-chain pointer, fetches the metadata, then fetches the image.

So the chain stores ownership and the token ID. IPFS stores the heavy stuff: the picture and its details. This is called a hybrid model, and most projects use it. To understand the on-chain side, this post on how NFT ownership works is a good companion.

Why do some NFT images break?

This is the part that catches beginners out. IPFS does not promise to keep your file forever on its own.

A file stays available only while at least one node keeps a copy of it. Keeping that copy is called pinning. If every node drops the file, the CID still exists in theory, but no one is serving the actual image. The picture goes blank or shows a broken link.

Older NFTs that used a normal web link (not IPFS at all) are even worse off. If that website shuts down, the image is gone. This is one quiet risk people forget when they buy.

| Storage type | Where the image lives | Risk | |---|---|---| | Plain web link | A company's server | Server shuts down, image gone | | IPFS (unpinned) | IPFS, if someone keeps it | Drops off if no one pins it | | IPFS (pinned) | IPFS, actively kept | Strong, as long as pinning continues | | Arweave | Paid permanent storage | Designed to last long-term | | Fully on-chain | The blockchain itself | Most permanent, costs the most |

What's the most permanent way to store an NFT image?

Two options stand out. Arweave is a storage network where you pay once for long-term storage, so the file is meant to stay put. Fully on-chain NFTs put the image data straight into the blockchain, like Bitcoin Ordinals do. Both are more permanent than a plain web link.

The catch is cost and size. On-chain storage is expensive and only works for small files. That's why most projects still use IPFS with pinning as a middle ground.

If you're a creator building your own collection, this matters a lot. Teams like Devwiz that build NFT projects plan storage early so the art doesn't break years later.

Frequently Asked Questions

Does my NFT image disappear if IPFS goes down?

The whole network rarely "goes down." The real risk is your specific file losing all its pinned copies. If the project or a service keeps pinning it, you're fine. If everyone drops it, the image can vanish.

How do I check where my NFT image is stored?

Look at the token's metadata URL on a marketplace or block explorer. If it starts with ipfs:// it's on IPFS. If it's a plain https:// web link, it depends on that one server staying online.

Is on-chain storage always better?

It's the most permanent, but it's costly and limited to small files. For most collections, well-pinned IPFS or Arweave is a sensible balance.

Can I pin my own NFT's image?

Yes. Services let you pin a CID so a copy is always kept. Some collectors do this for valuable NFTs to make sure the art never breaks.

The Bottom Line

Most NFTs don't store the picture on-chain. They store a pointer, and the image lives on IPFS, Arweave, or a plain server. IPFS is clever because it finds files by content, but it only works while someone keeps a copy pinned.

Next step: before you buy an NFT, check its metadata link. If the image is on a plain web server, treat that as a real risk. If it's pinned IPFS, on-chain, or Arweave, you're on safer ground.

About the Author

James Killick

AI Product, Web3 & Sales Automation Specialist

James Killick runs this site →

Digital Product Development

Devwiz is a Sydney-based digital product development agency specialising in launching and scaling SaaS products, web apps and mobile apps. James is a shareholder and advisor, shaping product strategy and PLG approach.

Visit Devwiz

// Related

Keep Reading