Home / Blog / Recursive Inscriptions

Recursive Inscriptions Explained: The Future of Bitcoin Art

Published: March 9, 2026 8 min read By SPUNK LLC

Recursive inscriptions are arguably the most important technical innovation in the Bitcoin Ordinals ecosystem. By allowing one inscription to reference and load content from another, recursive inscriptions enable complex, composable art built from small, efficient on-chain components. This is how the future of on-chain art is being built.

What Are Recursive Inscriptions?

A recursive inscription is an inscription that references the content of other inscriptions using their inscription ID. Instead of containing all data within a single inscription, artists can compose artworks from multiple on-chain sources.

Final Artwork (Inscription #3)
references
Background (Inscription #1)
Character (Inscription #2)

The reference mechanism uses the path /content/<inscription_id>. When an ordinals viewer renders the parent inscription, it fetches and displays the referenced content, assembling the final artwork from its components.

<!-- Example: Recursive HTML inscription -->
<html>
<body style="margin:0;background:#000">
  <!-- Load p5.js from an on-chain inscription -->
  <script src="/content/abc123...p5js_inscription_id"></script>

  <!-- Load shared style library -->
  <link rel="stylesheet" href="/content/def456...css_inscription_id">

  <!-- Reference an SVG background -->
  <img src="/content/ghi789...background_inscription_id">

  <script>
    // Your unique generative art code here
    // Uses the shared p5.js library loaded above
  </script>
</body>
</html>

Why Recursive Inscriptions Matter

Build Complex Art from Small Components

Without recursion, a complex interactive artwork might require 500KB+ inscribed in a single transaction. With recursion, the same artwork can be assembled from shared components, with the unique part being perhaps 2-5KB. The shared libraries and assets are inscribed once and reused by thousands of inscriptions.

Massive Cost Savings

Consider a 10,000-piece generative art collection. Without recursion, each piece might need 100KB, totaling 1GB of inscription data. With recursion, you inscribe the shared code library once (100KB) and each unique piece is just 1-3KB of configuration, totaling roughly 30MB — a 97% reduction in total on-chain data and inscription costs.

Composability

Recursive inscriptions create a composable layer on Bitcoin. An artist can reference another artist's inscribed background, a shared animation library, or a common color palette. This creates an interconnected web of on-chain art components that anyone can build upon.

Libraries on Bitcoin: p5.js, three.js, and More

Entire JavaScript libraries have been inscribed on Bitcoin for anyone to reference in their recursive inscriptions. This has transformed what is possible for on-chain generative art.

p5.js on Bitcoin

The popular creative coding library p5.js has been inscribed on Bitcoin, enabling rich 2D generative art. Artists reference the inscribed p5.js library and write their own small scripts that use it. The result is complex, interactive generative art where the rendering engine lives permanently on Bitcoin.

three.js on Bitcoin

three.js, the leading 3D JavaScript library, has also been inscribed. This enables 3D art, interactive 3D scenes, and even simple 3D games — all running from code stored entirely on the Bitcoin blockchain. The inscribed three.js serves as shared infrastructure for an entire category of 3D ordinal art.

Other Inscribed Libraries

Key Insight: These inscribed libraries are public goods on Bitcoin. Any artist can reference them for free (beyond the cost of inscribing their own artwork). This shared infrastructure dramatically lowers the barrier to creating sophisticated on-chain art.

Generative Art with Shared On-Chain Code

Generative art — art created by algorithms — is the category most transformed by recursive inscriptions. Here is how artists are using this capability:

The Pattern

  1. Inscribe shared code: The rendering library (p5.js, custom code) is inscribed once on Bitcoin
  2. Define parameters: Each unique piece in the collection is a small inscription containing just the seed values or configuration that make it unique
  3. Reference and render: Each piece loads the shared code and uses its unique parameters to generate a one-of-a-kind artwork

This approach means that the generative algorithm itself is permanently on Bitcoin, not just the output. Anyone can verify how any piece was generated by reading the on-chain code. This is true provenance and transparency.

How to Create Recursive Inscriptions

Step 1: Plan Your Architecture

Decide which components will be shared (libraries, backgrounds, common elements) and which will be unique (seeds, configurations, specific traits). Map out the reference hierarchy.

Step 2: Inscribe Shared Components First

Inscribe your shared libraries and assets. Record their inscription IDs — you will need these to build references in your artwork inscriptions.

Step 3: Build Your Artwork

Create your HTML/SVG inscription that references the shared components using /content/<inscription_id> paths. Test thoroughly using local development tools that simulate the ordinals content resolution.

Step 4: Test Before Inscribing

Use tools like the ord development server or sandboxed viewers to test your recursive inscriptions before committing them to Bitcoin. Inscriptions are permanent — test rigorously.

Step 5: Inscribe and Verify

Inscribe your artwork and verify it renders correctly on major ordinals explorers and marketplaces. Different viewers may handle recursive content slightly differently.

Notable Recursive Collections and Experiments

Explore Recursive Art

Browse the most innovative recursive inscriptions in our gallery

View Gallery on ordinals.pics