Easily keep track of which Gutenberg Blocks are used across your site.
On activation, the plugin will prompt you to index your content. You need to do this first before you will be able to see the various blocks used on your site. You can also go to WP-Admin > Tools > Block Catalog to do this yourself. Alternately, you can run the WP CLI command wp block-catalog index
to index your content from the command line.
Once indexed, you will be able to see the different blocks used on your site in the Block Catalog Taxonomy.
Navigating to any Block Editor post type will also show you the list of blocks present in a post.
You can also filter the listing to only show Posts that have a specific block.
Block Catalog uses a taxonomy to store the data about blocks used across a site. The plugin can build this index via the Tools > Block Catalog screen or via the WP CLI wp block-catalog index
. After the initial index, the data is automatically kept in sync after any content updates.
If your blocks are registered on the Backend with the old register_block_type API, you may be missing the title
attribute. The newer register_block_type_from_metadata uses the same block.json
on the FE and BE which includes the Block title.
When the plugin detects such a missing title
, it uses the blockName
suffix instead. eg:- xyz/custom-block will display as Custom Block.
To address this you need to update your custom block registration. If this is outside your control, you can also use the block_catalog_block_title
filter hook to override the title as seen here.
Beta
to Stable
(props @jeffpaul, @dkotter via #56).braces
from 3.0.2 to 3.0.3 (props @dependabot, @faisal-alvi via #58).ws
from 7.5.9 to 7.5.10 (props @dependabot, @faisal-alvi via #58).export
, to generate a CSV of the block catalog (props @dsawardekar, @psorensen, @Sidsector9 via #52).express
from 4.18.2 to 4.19.2 (props @dependabot, @Sidsector9 via #50).follow-redirects
from 1.15.5 to 1.15.6 (props @dependabot, @Sidsector9 via #50).postcss
from 7.0.39 to 8.4.33 (props @dependabot, @Sidsector9 via #50).10up-toolkit
from 5.2.3 to 6.0.1 (props @dependabot, @Sidsector9 via #50).webpack-dev-middleware
from 5.3.3 to 5.3.4 (props @dependabot, @Sidsector9 via #50).tj-actions/changed-files
from 39 to 41 (props @dependabot, @peterwilsoncc via #39).follow-redirects
from 1.15.2 to 1.15.4 (props @dependabot, @Sidsector9 via #40).sharp
from 0.32.3 to 0.32.6 (props @dependabot, @faisal-alvi via #32).Note that this release changes the name of the base plugin file. As such, you’ll probably need to reactivate the plugin after updating.
@babel/traverse
from 7.22.8 to 7.23.2 (props @dependabot, @dkotter via #21).Beta
Support Level (props @jeffpaul, @dsawardekar via #3).block_catalog_taxonomy_options
hook (props @dsawardekar, @fabiankaegy via #6).