{"id":201402,"date":"2024-09-02T16:43:32","date_gmt":"2024-09-02T16:43:32","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/block-finder\/"},"modified":"2026-05-16T12:22:27","modified_gmt":"2026-05-16T12:22:27","slug":"block-finder","status":"publish","type":"plugin","link":"https:\/\/test.wordpress.org\/plugins\/block-finder\/","author":3657560,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"1.1.0","stable_tag":"1.1.0","tested":"6.9.4","requires":"6.4","requires_php":"8.0","requires_plugins":null,"header_name":"Block Finder","header_author":"Troy Chaplin","header_description":"This plugin provides a dashboard to search for specific blocks","assets_banners_color":"b5c4c7","last_updated":"2026-05-16 12:22:27","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"","header_author_uri":"","rating":0,"author_block_rating":0,"active_installs":20,"downloads":1496,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.0":{"tag":"1.0.0","author":"areziaal","date":"2024-09-02 16:43:04"},"1.0.1":{"tag":"1.0.1","author":"areziaal","date":"2024-09-02 16:43:04"},"1.0.2":{"tag":"1.0.2","author":"areziaal","date":"2024-09-02 16:43:04"},"1.0.3":{"tag":"1.0.3","author":"areziaal","date":"2024-09-02 16:47:16"},"1.0.4":{"tag":"1.0.4","author":"areziaal","date":"2024-12-02 01:13:06"},"1.0.5":{"tag":"1.0.5","author":"areziaal","date":"2024-12-02 01:46:11"},"1.0.6":{"tag":"1.0.6","author":"areziaal","date":"2025-11-20 02:23:49"},"1.0.7":{"tag":"1.0.7","author":"areziaal","date":"2026-01-20 18:16:48"},"1.1.0":{"tag":"1.1.0","author":"areziaal","date":"2026-05-16 12:22:27"}},"upgrade_notice":[],"ratings":{"1":0,"2":0,"3":0,"4":0,"5":0},"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3533774,"resolution":"128x128","location":"assets","locale":"","width":256,"height":256},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3533774,"resolution":"256x256","location":"assets","locale":"","width":512,"height":512}},"assets_banners":{"banner-772x250.png":{"filename":"banner-772x250.png","revision":3533774,"resolution":"772x250","location":"assets","locale":"","width":1584,"height":513}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.0","1.0.1","1.0.2","1.0.3","1.0.4","1.0.5","1.0.6","1.0.7","1.1.0"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3533774,"resolution":"1","location":"assets","locale":"","width":1207,"height":991},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3533774,"resolution":"2","location":"assets","locale":"","width":1207,"height":991},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3533774,"resolution":"3","location":"assets","locale":"","width":1207,"height":1445},"screenshot-4.png":{"filename":"screenshot-4.png","revision":3533774,"resolution":"4","location":"assets","locale":"","width":1207,"height":1468}},"screenshots":{"1":"Block Finder dashboard widget ready to search various content types.","2":"Type ahead helps you easily find blocks in a list.","3":"Search results for published and draft posts containing the core paragraph block.","4":"Search results for the core group block in patterns and template parts."},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[4121,148076,18850,944,139732],"plugin_category":[59],"plugin_contributors":[231290],"plugin_business_model":[],"class_list":["post-201402","plugin","type-plugin","status-publish","hentry","plugin_tags-blocks","plugin_tags-gutenberg","plugin_tags-patterns","plugin_tags-search","plugin_tags-site-editor","plugin_category-utilities-and-tools","plugin_contributors-areziaal","plugin_committers-areziaal"],"banners":{"banner":"https:\/\/ps.w.org\/block-finder\/assets\/banner-772x250.png?rev=3533774","banner_2x":false,"banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/block-finder\/assets\/icon-128x128.png?rev=3533774","icon_2x":"https:\/\/ps.w.org\/block-finder\/assets\/icon-256x256.png?rev=3533774","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/block-finder\/assets\/screenshot-1.png?rev=3533774","caption":"Block Finder dashboard widget ready to search various content types."},{"src":"https:\/\/ps.w.org\/block-finder\/assets\/screenshot-2.png?rev=3533774","caption":"Type ahead helps you easily find blocks in a list."},{"src":"https:\/\/ps.w.org\/block-finder\/assets\/screenshot-3.png?rev=3533774","caption":"Search results for published and draft posts containing the core paragraph block."},{"src":"https:\/\/ps.w.org\/block-finder\/assets\/screenshot-4.png?rev=3533774","caption":"Search results for the core group block in patterns and template parts."}],"raw_content":"<!--section=description-->\n<p><strong>Ever needed to track down where a specific block is being used?<\/strong> 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 \u2014 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.<\/p>\n\n<p>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.<\/p>\n\n<h4>Who is this for?<\/h4>\n\n<p><strong>Content editors and site managers<\/strong> \u2014 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.<\/p>\n\n<p><strong>Developers and theme builders<\/strong> \u2014 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.<\/p>\n\n<h4>Features<\/h4>\n\n<p><strong>Search your way:<\/strong><\/p>\n\n<ul>\n<li>Type-ahead block picker powered by WordPress's native Combobox \u2014 no hunting through a long list<\/li>\n<li>Search Posts, Patterns, Templates, and Template parts all from one form<\/li>\n<li>Filter by post type to narrow results, or search across everything at once<\/li>\n<li>Filter by post status \u2014 include drafts, pending, scheduled, and private content alongside published<\/li>\n<\/ul>\n\n<p><strong>Understand what you find:<\/strong><\/p>\n\n<ul>\n<li>See the total number of times a block appears in each piece of content<\/li>\n<li>InnerBlock detection shows how many of those instances are nested inside another block<\/li>\n<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>\n<li>Status badges surface non-published content so nothing gets missed<\/li>\n<\/ul>\n\n<p><strong>Act on results quickly:<\/strong><\/p>\n\n<ul>\n<li>Direct edit links open any result straight in the block editor or Site Editor<\/li>\n<li>Paginated results keep large result sets easy to browse<\/li>\n<li>Filter between all instances and nested-only with a single click<\/li>\n<\/ul>\n\n<h4>For Developers and Theme Builders<\/h4>\n\n<p><strong>WP-CLI<\/strong> \u2014 run <code>wp block-finder search &lt;block&gt;<\/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.<\/p>\n\n<p><strong>Template and template part search<\/strong> \u2014 find blocks inside Site Editor templates on any block theme. Both file-based and database-stored templates are included.<\/p>\n\n<p><strong>Pattern search<\/strong> \u2014 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.<\/p>\n\n<p><strong>Developer hooks<\/strong> \u2014 extend or modify search behaviour without touching plugin code:<\/p>\n\n<ul>\n<li><code>block_finder_sources<\/code> \u2014 add or remove sources before the search runs<\/li>\n<li><code>block_finder_results<\/code> \u2014 modify the assembled result set before it is returned<\/li>\n<\/ul>\n\n<p><strong>REST API<\/strong> \u2014 <code>GET \/wp-json\/block-finder\/v1\/search<\/code> is available for custom integrations. Requires <code>edit_posts<\/code> capability.<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Upload the plugin folder to <code>\/wp-content\/plugins\/<\/code>, or install directly from the WordPress plugin directory.<\/li>\n<li>Activate the plugin from the <strong>Plugins<\/strong> page.<\/li>\n<li>Visit your WordPress <strong>Dashboard<\/strong> and find the <strong>Block Finder<\/strong> widget.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"how%20do%20i%20search%20for%20a%20block%3F\"><h3>How do I search for a block?<\/h3><\/dt>\n<dd><p>Open the WordPress dashboard and find the Block Finder widget. Type the name of any block into the search field, choose where to look (\"Search in\"), optionally narrow by post type and status, then click <strong>Find Block<\/strong>.<\/p><\/dd>\n<dt id=\"what%20does%20%22search%20in%22%20control%3F\"><h3>What does \"Search in\" control?<\/h3><\/dt>\n<dd><p>It lets you choose which content sources to include:<\/p>\n\n<ul>\n<li><strong>Posts<\/strong> \u2014 all public post types that support the block editor<\/li>\n<li><strong>Patterns<\/strong> \u2014 user-saved synced patterns plus any registered by your theme or plugins<\/li>\n<li><strong>Templates<\/strong> and <strong>Template parts<\/strong> \u2014 Site Editor content; only available on block themes<\/li>\n<\/ul><\/dd>\n<dt id=\"what%20are%20innerblocks%3F\"><h3>What are InnerBlocks?<\/h3><\/dt>\n<dd><p>InnerBlocks are blocks nested inside other blocks \u2014 a Paragraph inside a Group, or a Button inside a Cover. Block Finder shows you the total usage count and how many are nested, so you know whether a block appears standalone or embedded inside another.<\/p><\/dd>\n<dt id=\"can%20i%20search%20from%20the%20command%20line%3F\"><h3>Can I search from the command line?<\/h3><\/dt>\n<dd><p>Yes. With WP-CLI installed, run <code>wp block-finder search &lt;block-name&gt;<\/code> for a quick table output. Use <code>--format=count<\/code> for CI checks or <code>--format=csv<\/code> for audit exports. Run <code>wp block-finder search --help<\/code> for all available options.<\/p><\/dd>\n<dt id=\"does%20it%20work%20with%20custom%20post%20types%3F\"><h3>Does it work with custom post types?<\/h3><\/dt>\n<dd><p>Yes. Any public post type that supports the block editor is automatically included.<\/p><\/dd>\n<dt id=\"does%20it%20work%20with%20classic%20themes%3F\"><h3>Does it work with classic themes?<\/h3><\/dt>\n<dd><p>Partially. Post, pattern, and custom post type searches work on any theme. Template and template part search requires a block theme because those content types only exist in the Site Editor.<\/p><\/dd>\n<dt id=\"how%20do%20i%20uninstall%3F\"><h3>How do I uninstall?<\/h3><\/dt>\n<dd><p>Deactivate and delete the plugin from the Plugins page. All cached search data is removed from the database automatically on uninstall.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<p>View the full <a href=\"https:\/\/github.com\/troychaplin\/block-finder\/blob\/main\/CHANGELOG.md\">changelog<\/a> on GitHub.<\/p>","raw_excerpt":"Find any block, anywhere on your site \u2014 posts, patterns, templates, and template parts.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/test.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/201402","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/test.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/test.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/test.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=201402"}],"author":[{"embeddable":true,"href":"https:\/\/test.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/areziaal"}],"wp:attachment":[{"href":"https:\/\/test.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=201402"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/test.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=201402"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/test.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=201402"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/test.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=201402"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/test.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=201402"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/test.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=201402"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}