Find any block, anywhere on your site — posts, patterns, templates, and template parts.

Alvaro

Melonpan Block – Container

Block that provides a container, with styling features, which can have other blocks nested.

Troy Chaplin

Ever needed to track down where a specific block is being used? Block Finder adds a dashboard widget that searches your entire site for any core or custom block. Pick a block, click Search, and instantly see every place it appears — along with a count of how many times it’s used, whether it’s nested inside another block, and a direct link to edit that content.
No more manually opening posts one by one hoping to find the right block. Block Finder does the searching so you don’t have to.
<h4>Who is this for?</h4>
Content editors and site managers — need to update every post that uses a specific call-to-action block? Wondering which pages are still using a block you’re about to change? Block Finder gives you the answer in seconds, with one-click access to edit each result.
Developers and theme builders — auditing block usage across templates and template parts in the Site Editor, checking registered patterns, or running automated checks from the command line. Block Finder has you covered.
<h4>Features</h4>
Search your way:
<ul>
<li>Type-ahead block picker powered by WordPress’s native Combobox — no hunting through a long list</li>
<li>Search Posts, Patterns, Templates, and Template parts all from one form</li>
<li>Filter by post type to narrow results, or search across everything at once</li>
<li>Filter by post status — include drafts, pending, scheduled, and private content alongside published</li>
</ul>
Understand what you find:
<ul>
<li>See the total number of times a block appears in each piece of content</li>
<li>InnerBlock detection shows how many of those instances are nested inside another block</li>
<li>Source badges make it clear at a glance whether a result came from a post, a pattern, a template, or a template part</li>
<li>Status badges surface non-published content so nothing gets missed</li>
</ul>
Act on results quickly:
<ul>
<li>Direct edit links open any result straight in the block editor or Site Editor</li>
<li>Paginated results keep large result sets easy to browse</li>
<li>Filter between all instances and nested-only with a single click</li>
</ul>
<h4>For Developers and Theme Builders</h4>
WP-CLI — run <code>wp block-finder search <block></code> from the command line. Supports <code>--post-type</code>, <code>--post-status</code>, <code>--sources</code>, and <code>--format=table|json|csv|count|ids</code>. Use <code>--format=count</code> in CI pipelines or <code>--format=csv</code> for export and audit reports.
Template and template part search — find blocks inside Site Editor templates on any block theme. Both file-based and database-stored templates are included.
Pattern search — covers user-saved synced patterns and every pattern registered by your theme or plugins via <code>WP_Block_Patterns_Registry</code>, not just the ones saved to the database.
Developer hooks — extend or modify search behaviour without touching plugin code:
<ul>
<li><code>block_finder_sources</code> — add or remove sources before the search runs</li>
<li><code>block_finder_results</code> — modify the assembled result set before it is returned</li>
</ul>
REST API — <code>GET /wp-json/block-finder/v1/search</code> is available for custom integrations. Requires <code>edit_posts</code> capability.

Alternatives to Block Finder

Top alternatives