Recursive Inscriptions

Definition: Recursive Inscriptions are Ordinals inscriptions that use supported endpoints to retrieve and reuse content from other inscriptions. Compatible software assembles the referenced material when it renders the work; Bitcoin itself does not interpret or display the composition.2, 3

Protocol docs Ordinals documentation
Directories Bitcoin NFTs

How recursion works

Ordinals inscriptions store content in Bitcoin transactions and associate each inscription with a satoshi under Ordinals’ numbering conventions. Recursive inscriptions can request content from other inscriptions through endpoints exposed by compatible ord software. The current documentation describes a whitelisted set of endpoints, including a path for retrieving another inscription’s content. The Handbook treats recursion as an exception to inscription sandboxing: only documented endpoints are available, while HTML and SVG are sandboxed to prevent references to off-chain content. This lets an inscription request on-chain data without giving it general web access.2, 3

This lets a creator inscribe a shared resource once—such as an image, script, or stylesheet—and have later inscriptions refer to it. The referenced material remains its own inscription; recursion assembles related on-chain pieces when a compatible indexer or viewer resolves the references. It can reduce repeated data in a collection, but it does not remove the underlying resources or make a reference work when the viewer cannot retrieve it.3

What creators use it for

Ordinals documentation describes reuse and remixing, shared code or media, and generative collections built from a common algorithm plus item-specific data. A creator might inscribe a rendering program and separate data for each piece rather than repeat the same program in every inscription. A viewer then combines the referenced parts to display a composition.3

The Handbook identifies Inscription 12992 as the first recursive inscription on mainnet. It also describes OnChain Monkey Genesis (BTC) as one of the earliest collections to use recursion for profile-picture art.7

The design shifts some work from storing duplicated files to serving and interpreting references. A collection still depends on the inscriptions it calls, and the final appearance depends on software that understands those calls. “Recursive” describes how content is assembled; it does not describe a new Bitcoin asset class or a rule enforced by Bitcoin consensus.

How it differs from reinscription

A recursive inscription retrieves material from other inscriptions. A reinscription adds another inscription to a sat that already has inscription history. One combines references during rendering; the other records another inscription event. The terms describe different operations and should not be used interchangeably.2

Compatibility and limitations

Bitcoin nodes validate transactions under Bitcoin’s rules; they do not render recursive artwork or fetch referenced files. An Ord-compatible indexer or other software must implement the relevant endpoints and presentation behavior. A wallet, marketplace, or explorer can therefore recognize an inscription while failing to show the full recursive composition.1, 3

The Ordinals documentation says its recursive endpoints are whitelisted and documents backward-compatibility commitments for them. Implementers still need to handle changes the documentation allows, such as added response fields. For collectors, a durable Bitcoin record and a consistent display are separate questions: check the inscription references and confirm that the software used to view or transfer it supports the composition.3

History

  • December 23, 2022: The Ord project opened issue #1082 to discuss letting sandboxed HTML and SVG inscriptions access other inscriptions.4
  • June 10, 2023: The project merged pull request #2167, adding a restricted endpoint for inscriptions to request content from other inscriptions. This was an implementation change in Ord, not a change to Bitcoin consensus.5
  • June 15, 2023: The Ord 0.6.2 release included recursion documentation and recursive endpoints, making the feature available in a published software release.6

Last updated: 2026-11-16

Related Terms

Related Articles

See Also

Crypto Tools – A curated list by CryptoGloss

Sources

  1. Ordinals Project, “Overview,” Ordinal Theory Handbook — accessed November 16, 2026.
  2. Ordinals Project, “Inscriptions,” Ordinal Theory Handbook — accessed November 16, 2026.
  3. Ordinals Project, “Recursion,” Ordinal Theory Handbook — accessed November 16, 2026.
  4. Casey Rodarmor, “Recursion,” GitHub issue #1082 — opened December 23, 2022; closed June 10, 2023.
  5. Casey Rodarmor, “Recursive inscriptions,” GitHub pull request #2167 — merged June 10, 2023.
  6. Ordinals Project, “Release 0.6.2,” GitHub — released June 15, 2023.
  7. Ordinals Project, “Inscription Examples,” Ordinal Theory Handbook — accessed November 16, 2026.