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
- OpenSea’s Trading Cards Tab: What Do You Actually Own?
- NFTs and Digital Game Ownership: What Actually Changes
- Arweave, Filecoin, and the Promise of Permanent Blockchain Storage
- Why Crypto Calls It a Wallet—and What the Metaphor Hides
See Also
Crypto Tools – A curated list by CryptoGloss
Sources
- Ordinals Project, “Overview,” Ordinal Theory Handbook — accessed November 16, 2026.
- Ordinals Project, “Inscriptions,” Ordinal Theory Handbook — accessed November 16, 2026.
- Ordinals Project, “Recursion,” Ordinal Theory Handbook — accessed November 16, 2026.
- Casey Rodarmor, “Recursion,” GitHub issue #1082 — opened December 23, 2022; closed June 10, 2023.
- Casey Rodarmor, “Recursive inscriptions,” GitHub pull request #2167 — merged June 10, 2023.
- Ordinals Project, “Release 0.6.2,” GitHub — released June 15, 2023.
- Ordinals Project, “Inscription Examples,” Ordinal Theory Handbook — accessed November 16, 2026.