WP Manifestindependent plugin directory
manifest / developer / team51-block-locate

Team51 Block Locate

Find where a block type is used in the database (posts, templates, patterns, widgets) via Tools → Block Locate.

by WordPress.com Special Projects · github.com/a8cteam51/team51-block-locate · website

★ 0stars

Install

Download source zip No release zip yet

This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.

Install straight from GitHub with WP-CLI:

wp plugin install https://github.com/a8cteam51/team51-block-locate/archive/refs/heads/trunk.zip
No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
Readme github.com/a8cteam51/team51-block-locate ↗

Find where a block type is used in the database — post content (all relevant post types, including templates and synced patterns) and block widgets stored in options — from a simple admin screen under Tools → Block Locate.

Built by WordPress.com Special Projects.

What it does

Given a block name (e.g. passport/login or core/paragraph), the plugin scans the database and lists every location the block appears, with links to view and edit each match. It parses block markup with WordPress' own parse_blocks(), so nested/inner blocks are counted too.

Sources scanned:

  • Posts — all registered post types except revisions and similar system types (configurable), including templates (wp_template), template parts (wp_template_part), and synced patterns (wp_block).
  • Options — block widgets stored in widget_* options (optional, on by default).

Theme files (patterns and templates on disk) are not stored in the database and will not appear in results.

Usage

  1. Go to Tools → Block Locate (requires the manage_options capability).
  2. Enter a Block name:
    • Full namespace/slug (e.g. passport/login).
    • A leading wp: prefix is stripped automatically.
    • A bare slug (no /) defaults to the core/ namespace.
  3. Optionally narrow by Post types (comma-separated) and Post status.
  4. Optionally toggle Scan block widgets stored in options.
  5. Click Search to see matching locations, occurrence counts, and view/edit links.

Requirements

  • WordPress 6.0 or later
  • PHP 7.4 or later

Installation

  1. Copy the team51-block-locate directory into wp-content/plugins/.
  2. Activate Team51 Block Locate from the Plugins screen.

License

GPL v3 or later. See LICENSE.