Block Ledger

By Vlad Parole

0+ active installationsVersion 0.1.0

Governance, usage auditing, and safe lifecycle control for the WordPress block editor.

Description

Block Ledger is a control plane over the block editor — not another block library. It answers three questions content plugins never touch:

  • What is in my editor, and where is it used? A usage index built from parse_blocks() across posts, reusable blocks, and Full Site Editing templates.
  • What am I allowed to add? Allow/deny blocks globally or per post-type, and lock editor settings per role.
  • If I remove or update something, what breaks — and can I undo it? Retire a block type by rendering every in-use instance to portable static HTML, with a one-click restore snapshot.

The safe-deactivation feature is the anti-lock-in core: deactivate a block plugin without leaving broken markup behind.

Installation

  1. From your WordPress admin, go to Plugins > Add New.
  2. Search for Block Ledger, click Install Now, then Activate.
  3. Open any post in the block editor; the Block Ledger panel opens from the “+” more menu on the top bar.

Building from source

Clone the repository and run npm install && npm run build to compile the editor assets into build/.

FAQ

Does Block Ledger add content blocks?

No. It is a control panel, not a block library. It adds no content blocks of its own.

Will hiding a block delete existing content?

No. Hiding a block removes it from the inserter only. Existing content that uses that block is untouched.

What does “retire” do?

Retire converts every instance of a block to plain static HTML and snapshots the original. This lets you remove a block plugin without breaking pages. Restore brings the original back.

Is the Pro tier a paywall inside the free plugin?

No. The free plugin is 100% GPL with no feature gates. Pro is a separate plugin or external purchase flow only.

Can I use this on multisite?

Yes. The usage index and policy settings are stored as site options. Network admins can manage policies from Tools → Block Ledger.

Screenshots

Changelog

0.1.0

  • Initial release.
  • Site-wide block usage index with counts.
  • Hide/show blocks from inserter (global + per post-type).
  • Safe retire/restore with snapshot.
  • Tools → Block Ledger admin dashboard.
  • Editor sidebar panel fallback.

0.1.0

  • Initial release: usage ledger, inserter allow/deny policy, safe block retirement with restore.