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.