Mutable vs Frozen NFT Metadata: What Locking Really Means

snft mutable vs frozen nft metadata

Most people assume that once an NFT is minted, its image and details are fixed forever. That is not always true. Whether an NFT can change after minting depends on how its metadata is stored and who is allowed to edit it. This guide explains the difference between mutable and frozen metadata, why it matters, and what creators and collectors can check.

A Quick Reminder: What Metadata Points To

An NFT on the blockchain usually does not hold the artwork itself. It holds a token ID and a link, often called the token URI. That link points to a JSON file with the name, description, traits and the address of the image. If you want the full background, our guide on what NFT metadata is covers the basics.

Because the chain stores only the pointer, two separate questions decide whether your NFT can change:

  • Can the pointer (the token URI) be changed by someone?
  • Can the file at the end of the pointer be changed by someone?

Both need to be locked for the NFT to be truly fixed.

What Mutable Metadata Means

Mutable metadata means the creator, the contract owner or another authorized party can still edit what the NFT shows. This can happen in two ways.

  • The contract lets the owner update the URI. Many contracts include a function that changes the base URI for a collection. It is useful for things like a planned reveal, but it also means the owner could point every token somewhere else.
  • The file is hosted on a normal web server. If the URI is an ordinary HTTPS address, whoever controls that server can swap the file. The link on the chain never changes, but the content does.

Mutability is not automatically bad. Some projects rely on it on purpose, for example dynamic NFTs that update with in-game progress, or a collection that stays hidden until a delayed reveal. The concern is when metadata can change without buyers knowing about it or agreeing to it.

What Frozen Metadata Means

Frozen (or locked) metadata means the token URI can no longer be changed, and the content it points to cannot be swapped either. In practice, freezing usually combines two steps:

  1. Store the files on content-addressed storage. On IPFS or Arweave, the address is derived from the file contents. If the file changes, the address changes, so an existing link cannot quietly show different content. Files on IPFS still need to stay available, which is where pinning comes in.
  2. Disable the ability to change the URI. The contract either has no update function, or the owner calls a freeze action that permanently switches it off.

Some marketplaces have built features around this. OpenSea, for example, has documented a convention where a contract emits a PermanentURI event to signal that a token’s URI should never change again, and it has offered creators a way to freeze metadata for tokens. Support and details vary by marketplace and change over time, so check the current documentation of the platform you use.

Where ERC-4906 Fits In

There is also a standard for the opposite situation. ERC-4906 is an optional extension to ERC-721 that defines a MetadataUpdate event and a BatchMetadataUpdate event. A contract emits them when a token’s metadata changes, so marketplaces and apps can refresh what they display instead of showing stale data.

It is important to understand what this standard does and does not do. It helps platforms notice changes. It does not prevent changes and it does not prove metadata is safe. A collection that emits update events is mutable by design. A frozen collection, in contrast, has nothing left to announce.

Why It Matters for Collectors

If you buy an NFT with mutable metadata, you are trusting the party who controls it. Possible risks include:

  • The image or traits being replaced after you buy.
  • Files disappearing if a private server goes offline, which leaves a token that points to nothing. Our article on NFT images not showing explains how this looks in a wallet.
  • Rarity traits being edited, which affects how a piece compares with others in a collection.

Frozen metadata does not make an NFT valuable, safe or a good purchase. It only reduces one specific kind of risk: unexpected edits. It also cannot fix a problem that was frozen in, such as a typo in a trait or a broken image link, so verify before locking.

Why It Matters for Creators

If you are minting your own work, you have a choice to make, and it is worth making it deliberately:

  • Freeze when the piece is final. For a single artwork or a finished collection, locking metadata tells buyers the piece will stay as it was minted.
  • Stay mutable when there is a reason. If the NFT is meant to evolve, or you plan a reveal, keep updates possible and explain the plan clearly on your project page.
  • Be open about your choice. Say whether metadata is frozen, where files are stored, and who can change what. Clear disclosure builds more trust than any claim of permanence.

How to Check Before You Mint or Buy

  1. Open the token URI. On a block explorer, read the token URI and see whether it starts with ipfs://, an Arweave address or a plain https:// link.
  2. Look for an update function. On a verified contract, check whether functions such as setBaseURI or setTokenURI exist and who is allowed to call them.
  3. Check marketplace indicators. Some marketplaces show whether metadata is frozen or where it is stored.
  4. Read the project’s own statement. A reliable project explains its metadata policy in plain language. If it says nothing, treat that as a question mark.

Key Takeaways

  • An NFT is only fixed if both the URI and the file behind it are locked.
  • Mutable metadata is a legitimate design choice, but it requires trusting whoever can edit it.
  • Frozen metadata usually means content-addressed storage plus a disabled update function.
  • ERC-4906 announces metadata changes. It does not prevent them.
  • Check the token URI and contract yourself rather than relying on a single label.

Simple NFT Creator is a mobile app for creating and minting NFTs, and it is available on the App Store and Google Play. Whichever tool you use, decide early whether your metadata should stay open or be locked, and tell your buyers what you chose.