Block Directory

Go back to the list of Blocks

The Block Directory is a new way for block editor users to discover, test and install new blocks on their website. It is available to content creators who have the capability to install and activate plugins.

How to use the Block Directory

  1. Select the “+” icon at the top, left-hand corner of the editor to open the Block Inserter.
The editor with icons displayed at the top, above the page content
  1. Type a keyword in the search field of the Inserter, like “team” or “staff”.

WordPress first searches the current site for the block named “team” or “staff”. If it doesn’t find a block, it searches in the Block Directory which is a special corner of the WordPress plugin repository, where single block plugins are available.

If no blocks are found in either case, a link to the Block Editor Handbook is displayed with details on how to create your own blocks.

No results in the Block Directory, which displays a notice about creating your own block
  1. If the search finds blocks, they will be displayed in the inserter, including a preview section. Decide which block to use and select it to add it to the page.
Blocks found in the block directory

In the background the single-block plugin is installed and activated, and the user can continue creating the page.

  1. If the first choice doesn’t suit your needs, you can go back to the search and select a different one that also will be installed.

Examples of tested single-block plugins

How to uninstall the block

Blocks from the Block Directory are installed as a plugin. To uninstall a block that you installed from the Block Directory, go to the Plugins screen. Find the block plugin and deactivate and delete to uninstall the block.

How to uninstall the block

How to reinstall a block

If a previously used block is no longer available on the site, you have the option to reinstall it.

When the page is first loaded, a search will be done in the background to check if that block is still available. If it has been found, a Reinstall block button will be displayed in place of the missing block on the page. Select the button to automatically reinstall the missing block.

Examples: Missing block with “Reinstall block” and “Keep as HTML” options, then a missing block with a “Keep as HTML” button.

Keep as HTML link will also be displayed, or it will be the only button present if no matching block was found when the page loaded.

You can choose that option instead. It lets you convert the content into a custom HTML block so you still have a chance to use the content of the block you had before.

You could also choose to remove the missing block and choose another one from the Block Directory using the steps outlined above.

Video showing how the Block Directory works

In this video shows you how the Block Directory works. It’s starts at 3:00 time stamp. Start it at the beginning if you are new to the block editor and need a refresher.

On contributors started creating workshop videos for self-study and scheduled discussion groups online. Check it out.


  • Updated 2023-02-09
    • Reworded the Install and Uninstall sections
    • Added reinstall section
  • Updated 2022-06-14
    • Removed one of the single block examples that was out of date.
  • Updated 2020-08-17
    • Embeded video from
    • Added link to original source of the video
    • Added link to Series “Introduction to Publishing with the Block Editor
    • Added shout-out to site with links
  • Updated 2020-08-10
    • Added Changelog
    • Added Resource Links
  • Created 2020-07-27

Was this article helpful? How could it be improved?

First published

Last updated