Help Center/NFTs & the Explorer/Make sure every NFT has an Explorer entry (admin backfill)
NFTs & the Explorer•Last updated: 2026-10-19•4 min read

Make sure every NFT has an Explorer entry (admin backfill)

Run a dry run, then apply, to create Explorer entries for NFTs, sales and listings that predate automatic indexing.

Have questions or need step-by-step guidance on this topic?

Ask AI Copilot

Step-by-Step Procedure

1

Open the "NFT explorer index" panel

Go to Admin, Explorer, "Indexer State & Engine". The "NFT explorer index" panel shows NFTs, how many have a mint entry, how many are missing, and the sales and listing events without an entry. It also states whether the entries are stored durably or only in memory.

2

Run a dry run

Click "Run dry run". Nothing is written. The panel lists the entries that would be created ("Dry run result: N explorer entries would be created").

3

Review the plan

Check the listed kinds (MINT, LIST, UNLIST, SALE) and NFT ids. Entries for NFTs with no recorded chain hash are labelled OFF_CHAIN reference entries, not on-chain claims.

4

Apply

Click "Apply backfill". It is only enabled after a dry run found something to do, and it applies exactly the plan you reviewed. If the NFT data changed meanwhile the server refuses and asks you to dry-run again.

5

Confirm

The coverage line updates; "missing" should be 0. Running the dry run again reports 0 entries (the backfill is idempotent).

Expected Operational Outcome

Every NFT, sale and listing has an Explorer entry (token page, provenance, holder, transaction history).

Troubleshooting & Failure Modes

Symptom: Apply is refused with "The NFT data changed since the dry run"
Likely Cause: An NFT, sale or listing changed between the dry run and the apply.
Resolution: Click "Run dry run" again and apply the new plan.
Symptom: Storage says IN_PROCESS_ONLY
Likely Cause: Durable state is off in this server process, so entries are held in memory only.
Resolution: Enable durable state (a database URL and I8_DURABLE_STATE not set to off) and re-run the backfill.

Was this guide helpful?

Help us refine our platform documentation