Title: Blockwright Workbench
Author: markrussellwp
Published: <strong>15 August 2026</strong>
Last modified: 15 August 2026

---

Search plugins

![](https://ps.w.org/blockwright-workbench/assets/banner-772x250.png?rev=3649102)

![](https://ps.w.org/blockwright-workbench/assets/icon-256x256.png?rev=3649102)

# Blockwright Workbench

 By [markrussellwp](https://profiles.wordpress.org/markrussellwp/)

[Download](https://downloads.wordpress.org/plugin/blockwright-workbench.1.0.0.zip)

 * [Details](https://en-gb.wordpress.org/plugins/blockwright-workbench/#description)
 * [Reviews](https://en-gb.wordpress.org/plugins/blockwright-workbench/#reviews)
 *  [Installation](https://en-gb.wordpress.org/plugins/blockwright-workbench/#installation)
 * [Development](https://en-gb.wordpress.org/plugins/blockwright-workbench/#developers)

 [Support](https://wordpress.org/support/plugin/blockwright-workbench/)

## Description

Building or maintaining a block theme means fighting the file-to-database drift:
Site Editor edits are saved to the database and silently override your theme files.
WordPress can reset those overrides only one item at a time, through buried menus,
and some cleanups (rescanning pattern files, flushing the theme.json cache and OPcache)
have no button anywhere.

The Workbench puts the whole development loop in one admin-bar menu:

 * **Reset Site Editor overrides** for the active theme (templates, template parts,
   global styles) in one click
 * **Rescan theme patterns**, clearing the pattern-file cache first so newly added
   pattern files actually appear
 * **Flush every cache** that hides your changes: object cache, theme.json cache,
   OPcache
 * **Clear all transients**

Safe by design: the Workbench is OFF by default and only appears in a development
environment (`wp_get_environment_type()`), or when you opt in with `define( 'BLOCKWRIGHT_WORKBENCH',
true );` in wp-config. Every tool is capability-gated and nonce-protected; the one
destructive tool requires an explicit confirmation.

Pairs well with the official Create Block Theme plugin: use Create Block Theme to
save the changes you want INTO your theme files, and the Workbench to clear out 
the state you do not want.

Works with any block theme.

## Screenshots

[[

## Installation

 1. In your dashboard, go to Plugins, then Add New, then Upload Plugin.
 2. Upload the Blockwright Workbench zip and click Install Now.
 3. Click Activate.
 4. On a site whose environment type is `local` or `development` (`wp_get_environment_type()`),
    the Workbench menu appears in the admin bar right away for users who can edit themes.
    Anywhere else, nothing is shown until you opt in by adding `define( 'BLOCKWRIGHT_WORKBENCH',
    true );` to wp-config.php.

## FAQ

### I do not see the Workbench menu

That is the safety gate. It appears only when `wp_get_environment_type()` is `local`
or `development`, or when wp-config defines `BLOCKWRIGHT_WORKBENCH` as true, and
only for users with the `edit_theme_options` capability.

### Is this destructive?

One tool does, on purpose: Reset Site Editor permanently deletes the database rows
that override your theme’s template, template part and global styles files, so the
files win again. It bypasses the trash, so anything customised in the Site Editor
and never exported to your theme is gone. It is marked destructive, requires a confirmation
click, and never runs on a production site unless you explicitly enabled the Workbench
there.

## Reviews

There are no reviews for this plugin.

## Contributors and Developers

“Blockwright Workbench” is open source software. The following people have contributed
to this plugin.

Contributors

 *   [ markrussellwp ](https://profiles.wordpress.org/markrussellwp/)

[Translate “Blockwright Workbench” into your language.](https://translate.wordpress.org/projects/wp-plugins/blockwright-workbench)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/blockwright-workbench/),
check out the [SVN repository](https://plugins.svn.wordpress.org/blockwright-workbench/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/blockwright-workbench/)
by [RSS](https://plugins.trac.wordpress.org/log/blockwright-workbench/?limit=100&mode=stop_on_copy&format=rss).

## Change Log

#### 1.0.0

 * Initial public release: four tools for block-theme development, off by default
   outside a development environment.
 * Reset Site Editor overrides, rescan theme patterns, flush every cache, and clear
   all transients.
 * Every tool is capability-gated and nonce-protected; Reset Site Editor requires
   an explicit confirmation.

## Meta

 *  Version **1.0.0**
 *  Last updated **23 hours ago**
 *  Active installations **Fewer than 10**
 *  WordPress version ** 7.0 or higher **
 *  Tested up to **7.0.4**
 *  PHP version ** 7.4 or higher **
 *  Language
 * [English (US)](https://wordpress.org/plugins/blockwright-workbench/)
 * Tags
 * [block-theme](https://en-gb.wordpress.org/plugins/tags/block-theme/)[cache](https://en-gb.wordpress.org/plugins/tags/cache/)
   [developer](https://en-gb.wordpress.org/plugins/tags/developer/)[reset](https://en-gb.wordpress.org/plugins/tags/reset/)
   [site editor](https://en-gb.wordpress.org/plugins/tags/site-editor/)
 *  [Advanced View](https://en-gb.wordpress.org/plugins/blockwright-workbench/advanced/)

## Ratings

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/blockwright-workbench/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/blockwright-workbench/reviews/)

## Contributors

 *   [ markrussellwp ](https://profiles.wordpress.org/markrussellwp/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/blockwright-workbench/)