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
- Select the “+” icon at the top, left-hand corner of the editor to open the Block Inserter.
- 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.
- 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.
In the background the single-block plugin is installed and activated, and the user can continue creating the page.
- 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 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.
A 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 Learn.WordPress.org contributors started creating workshop videos for self-study and scheduled discussion groups online. Check it out.
- Introduction to the Block Directory (Video)
- Series: Introduction to Publishing with the Block Editor
- Single Block Plugins available through the Block Directory
- Proposed Block Directory guidelines
- 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 Learn.WordPress.org
- Added link to original source of the video
- Added link to Series “Introduction to Publishing with the Block Editor
- Added shout-out to learn.WordPress.org 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?
Log in to submit feedback. If you need suppport with something that wasn't covered by this article, please post your question in the support forums.