WordPress.org

Description

Find My Blocks is a WordPress plugin built to help you find specific Gutenberg blocks on your WordPress website.

🔍 Fast search for block locations

Save your time by scanning your entire WordPress site (including posts, pages and custom post types) to locate instances of WordPress Blocks.

📍 Find & replace blocks safely with quick edit and preview links.
🧱 WordPress Full Site Editing support. Block Templates & Template parts will be searched.
⚡️ Performance settings for low (shared hosting) to high-end hosting.
🤝 100% free & open source.

Which blocks can be located?

Find My Blocks will batch loop through your posts (and more) to detect instances of blocks.

WordPress Core blocks (paragraphs, images, group blocks and so on)
Blocks added by third-party plugins (Even if they are uninstalled)
Synced Patterns (Reusable Blocks)
WordPress template added by your theme, or plugins such as WooCommerce.
Conditional Blocks with custom visibility settings.

Anything missing? Let us know – our goal is to find every WordPress block.

Quickly identify block types.

Filter found blocks by their “Block Provider”, narrowing the search results to individual plugins.
The amount of times a specific block type has been used on your WordPress website.
The posts/pages that a block has been used on.
The amount of times a block has been used on a specific post/page.
Check if the block is a “Synced Pattern (Reusable Block)”.
Check if the block is a “Nested Block”.
Check if the block is a “Template”.

How to get started?

Navigate to the Tools -> Find My Blocks Menu inside the WordPress Admin dashboard. You can then set your server performance, which will decide how many posts to scan at a time.

Once it’s done you’ll see all found blocks!

Resources

Website: Read our guides and tutorials.
GitHub: Contribute to the plugin.
@MorganHvidt: Follow Morgan on X (Twitter).

Screenshots

Find My Blocks – Start Search
Find My Blocks – Searching Progress
Find My Blocks – Found Blocks within WordPress Content.

Installation

Upload the plugin files to the /wp-content/plugins/find-my-blocks directory, or install the plugin through the WordPress plugins screen directly.
Activate the plugin through the ‘Plugins’ screen in WordPress
Use the Tools->Find My Blocks screen to locate all of your blocks

FAQ

Will this work with custom blocks

Yes, this plugin will work with all blocks registered and used on your site.

Can it find WordPress blocks from uninstalled plugins?

Yes, you don’t have to worry about whether a third-party plugin is installed or not. Find My Blocks will look at all your WordPress posts. Old block names are still stored within the post, therefore they will still be located and listed for you on the results page.

What Post Types does it search?

Find My Blocks will automatically determine which Post Types have the WordPress editor enabled. Therefore only the necessary posts will be searched. You’ll be able to identify which post type each block belongs to on the result page.

Who is behind this plugin?

Morgan Hvidt is the current developer for Find My Blocks. You can follow him on Twitter / X @morganhvidt or morganhvidt.com

A special thanks to Edeesims who originally created the Find My Blocks plugin.

Reviews

Ronald Huereca April 7, 2024

I’m trying to overcome block debt to improve site performance and this plugin is such a lifesaver. It detects old blocks, current ones, tells where there’s at with a link to edit the page… my goodness is this a timesaver. You and all involved deserve major kudos for such an incredibly intuitive and easy-to-use plugin

MJ February 15, 2024 2 replies

The Find My Blocks plugin would not work with my website, which is using WP 6.4.2 and the Twenty Twenty Four theme. I posted a question on the support side of this plugin, but I guess I should have instead posted a review. No one responded to my support post. I just wanted to warn people that despite what other people have written, this plugin kept freezing, and it writes stuff to your database that resides permanently even after you delete the plugin. (sorry, but this website will not let me insert a link to my support post)

marcomstudio December 27, 2023 1 reply

I’m using this on Wordpress 6.4.2 and it works. This is just such a useful piece of kit. It even finds ACF defined blocks and filters removed blocks.Extra points for putting it in the Tools menu.Hero of the day.(Can you do the same for images please? 😉

Michael Hanttula October 20, 2023

Find My Blocks is a powerful tool when wishing to manage a block-based site. It gives you the ability to see across your site for all instances of specific block types. This is especially helpful when you’re wishing to replace or modify a block type on a site-wide scale.As block libraries grow and there become a multitude of similar, overlapping block types, the Find My Blocks plugin will be especially helpful in optimizing & standardizing your site.In short: don’t build a block-based site without Find My Blocks.

Doug Smith September 9, 2023

I had installed many sets of blocks to try out and ended up with a lot of overlap of block types and a mess of using a few blocks from one plugin, and a few from another, and a few more from others. Find My Blocks gave me a way to clean up the mess without the risk of removing blocks that content depended on.

Johan van der Wijk February 3, 2023

A must-have plugin to keep the number of Gutenberg blocks plugins to under control.

Read all 39 reviews

Contributors & Developers

“Find My Blocks – Locate blocks on your site” is open source software. The following people have contributed to this plugin.

“Find My Blocks – Locate blocks on your site” has been translated into 6 locales. Thank you to the translators for their contributions.

Translate “Find My Blocks – Locate blocks on your site” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

4.0.3

Ready for WordPress 6.6
Increased low performance option from 10 to 30 posts per batch.
Updated usage of the “Performance” option to be more clear.

4.0.2

Find My Blocks now works better than ever on large sites with 10,000+ blocks found.

Replaced LocalStorage with IndexedDB for caching found blocks between page reloads.
Performance improvements when view more than 2000+ found blocks.
Improved error handling.

4.0.1

Improvement: Reliability during scan – use WP_Query pages instead total scanned posts because some posts might be skipped.

4.0.0

Major update

Hi everyone, I’ve adopted Find My Blocks and completely rebuilt the plugin. Please consider leaving a review or let me know if you run into any issues. – Morgan –

Optimized Batch Search: Improved search performance tailored to server capabilities, works well on shared hosting.
Smart Post Type Detection: Automatic recognition of post types using the Block Editor.
Full Site Editing Capabilities: Search now includes Synced Patterns, Block Templates, and Template Parts.
Detect Classic Blocks: Classic Blocks are now detectable.

UI & Experience

Revamped Interface: A sleeker design that is consistent with the WordPress admin color scheme.
Enhanced Block Filtering: Sort blocks by source, including core WordPress blocks and those from external plugins.
Post Type Visibility: New indicators show clear post type identification.
Full Site Editing Preview and Edit Links: Improved Full Site Editing with preview and edit capabilities for custom templates.

Performance and Compatibility

Browser Caching for Scans: Browser cache utilization to reduce server load and prevent redundant searches.
Bug Fixes and Compatibility Improvements:
- Fixed React v18 compatibility issues.
- Enhanced security with apiFetch from WordPress.
Compatibility: Ensured compatibility with PHP 8.3 (minimum PHP 7.4) and WordPress 6.5 (minimum WordPress 5.0).

Security and Permissions

Updated Access Permissions: The “edit-posts” capability is now required to use Find My Blocks.

Internationalization and Integration

Internationalization: Added default text domain and language folder for plugin translations.
Third-Party Integration: Compatibility with Conditional Blocks.

Clean Up and Maintenance

Clean Uninstallation: Automatic cleanup of plugin data upon removal.

3.5.3

Changes the icon for “# of usages in Post” for clarity

3.3.2

Fixes the broken wp-json url
Updates the donate link to a BuyMeACoffee Link

3.3.1

Uses get_rest_url for the fetch url.

3.3.0

Uses get_admin_url for the edit link to avoid redirect loops.

3.2.0

Adds the site_url() to the fetch url.

3.1.3

Fixes a 🐛 that was causing the plugin to not load on some sites.

3.1.0

Allows for filtering by block name on the API endpoint. (/wp-json/find-my-blocks/blocks?name=core/button)

3.0.0

Changes to use WordPress components and match WordPress styling
Includes private, pending, and future status posts in main query
Allows the ability to optionally include drafts
Fixes a 🐛 where cards would change order for no reason

2.3.0

Checks for nested blocks.
Adds a tag to a card if the block is nested

2.2.0

Hides the “core-embed” blocks with the “Hide Core Blocks” option.
Fixes the broken link when plugin is first activated.

2.1.0

Moves the menu item to Tools > Find My Blocks.
Hides core blocks by default. The option to show and hide core blocks is now
in settings.
Settings moved from top of blocks to side on wider screens.

2.0.2

Fixed the navigation showing ‘Found in 1 postfalse’ when only one post found

2.0.1

Fixed a bug where the page refresh didn’t properly set the active block

2.0.0

Moves Find My Blocks out of the Settings menu and into its own sidebar item
Layout moved off of WordPress components to allow better testing
On initial load, the proper first navigation will be selected as active
When the page is refreshed, the selected block will stay active
Allows sorting of navigation and cards
Launches official website https://find-my-blocks.edeesims.com/

1.4.0

Allows the editor role to use the plugin

1.3.0

Sorts the list of the navigation alphabetically.
Sorts the list of pages alphabetically.
Some updates to styling to bring more inline with Gutenberg and WordPress
core.

1.2.0

Adds a Filter Input to allow you to filter blocks in the menu.
Updates the style of the header to be just a little bit nicer.
Adds a loading screen so that you are not bored waiting for the page to load.

1.1.0

Adds a message to notify the amount of times a block has been used in a post.
Removes some old, unused functionality.

1.0.0

Initial Release