About the WordPress Block Reference


This page gives you a brief introduction to this WordPress Block Reference. The blocks.wp-a2z.org website, a sub-domain of wp-a2z.org, is a catalogue of Blocks and Themes that have been developed for the WordPress Block editor aka Gutenberg.


To catalogue:

A complete reference of blocks would list all the known blocks and their source components: core, plugin, theme, or otherwise. This will always be a work in progress; the number of plugins that offer blocks is growing daily. Ditto for Full Site Editing themes.



The basic process of documenting blocks is:

  1. Choose a plugin to be included in the directory.
  2. Install it.
  3. Register it, creating a summary of the blocks it delivers.
  4. Automatically generate Block CPTs and associated meta data for those blocks.
  5. Manually edit the generated Blocks CPTs
  6. Go to 1.

This semi automatic registration of each block will help us to build an index that may make block discovery easier. The custom taxonomies will allow the Block catalogue to be seen from a range of viewpoints.

This solution will not help with the seamless installation. It will only help you identify the blocks you might want and the components you’ll need to deliver them.

FSE Themes

For themes on wordpress.org the process is:

  1. Obtain a list of FSE themes
  2. For each theme on the list
    1. Obtain the theme info from wordpress.org
    2. Download the latest theme version
    3. Update the Theme CPT
  3. Go to 1.

For child themes the template theme needs to have been registered.

The theme display logic can list the theme’s templates and template parts but cannot determine which patterns the theme provides unless it loads the theme.

Recent blog posts – Block News

Please also refer to these items of Block News for more information about the process and status.

Other references

Behind this website

  • This site is being developed by Herb Miller @herb_miller.
  • The plugins and themes used to create the site are Open Source – see bobbingwide.