Title: Block Directory Author: Akira Tachibana Published: July 27, 2020 Last modified: January 3, 2025 --- # Block Directory ## In this article * [How to use the Block Directory](https://wordpress.org/documentation/article/block-directory/?hsSkipCache=true&output_format=md#how-to-use-the-block-directory) - [Examples of tested single-block plugins](https://wordpress.org/documentation/article/block-directory/?hsSkipCache=true&output_format=md#3-examples-of-tested-single-block-plugins) * [How to uninstall the block](https://wordpress.org/documentation/article/block-directory/?hsSkipCache=true&output_format=md#how-to-uninstall-the-block) * [How to reinstall a block](https://wordpress.org/documentation/article/block-directory/?hsSkipCache=true&output_format=md#how-to-reinstall-a-block) * [Video showing how the Block Directory works](https://wordpress.org/documentation/article/block-directory/?hsSkipCache=true&output_format=md#video-showing-how-the-block-directory-works) * [Resource links](https://wordpress.org/documentation/article/block-directory/?hsSkipCache=true&output_format=md#resource-links) * [Changelog](https://wordpress.org/documentation/article/block-directory/?hsSkipCache=true&output_format=md#changelog) [ Back to top](https://wordpress.org/documentation/article/block-directory/?hsSkipCache=true&output_format=md#wp--skip-link--target) [Go back to the list of **Blocks**](https://wordpress.org/documentation/article/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](https://wordpress.org/documentation/article/block-directory/?hsSkipCache=true&output_format=md#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](https://wordpress. org/documentation/files/2020/07/block-directory-inserter-0-6.7-1024x336.jpg) 2. 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 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](https://wordpress.org/documentation/files/ 2020/07/block-directory-inserter-1-6.7.jpg) In the background the single-block plugin is installed and activated, and the user can continue creating the page. 3. If no blocks are found in either case, a [link to the Block Editor Handbook](https://developer.wordpress.org/block-editor/) 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](https://wordpress.org/documentation/files/2020/07/block-directory-inserter- 2-6.7-1024x471.jpg) 4. 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](https://wordpress.org/documentation/article/block-directory/?hsSkipCache=true&output_format=md#3-examples-of-tested-single-block-plugins)󠁿 * [Block for Apple Maps](https://wordpress.org/plugins/maps-block-apple/), * [Event block](https://wordpress.org/plugins/event/), * [User Profile Block](https://wordpress.org/plugins/user-profile-block/) ## 󠀁[How to uninstall the block](https://wordpress.org/documentation/article/block-directory/?hsSkipCache=true&output_format=md#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](https://wordpress.org/documentation/files/2023/02/ Screenshot-2023-02-09-at-4.42.00-PM-1024x367.png) ## 󠀁[How to reinstall a block](https://wordpress.org/documentation/article/block-directory/?hsSkipCache=true&output_format=md#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 **Install [block name]** 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 “Install [block name]" and “Keep as HTML” options.]( https://wordpress.org/documentation/files/2020/07/block-directory-reinstall-6.3- 1024x241.png) A **Keep as HTML** button 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](https://wordpress.org/documentation/article/block-directory/?hsSkipCache=true&output_format=md#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 ](https://learn.wordpress.org/)contributors started creating workshop videos for self-study and [scheduled discussion groups online](https://www.meetup.com/learn-wordpress-discussions). Check it out. _ ## 󠀁[Resource links](https://wordpress.org/documentation/article/block-directory/?hsSkipCache=true&output_format=md#resource-links)󠁿 * [Introduction to the Block Directory (Video)](https://learn.wordpress.org/workshop/intro-to-the-block-directory/) * [Series: Introduction to Publishing with the Block Editor](https://learn.wordpress.org/workshop/intro-to-publishing-with-the-block-editor/) * [Single Block Plugins available through the Block Directory](https://wordpress.org/plugins/browse/block/) * [Proposed Block Directory guidelines](https://make.wordpress.org/plugins/2020/07/22/proposed-block-directory-guidelines/) ## 󠀁[Changelog](https://wordpress.org/documentation/article/block-directory/?hsSkipCache=true&output_format=md#changelog)󠁿 * Updated 2025-0103 - Updated screenshots with WordPress 6.7 * 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? 󠀁[Cancel reply](https://wordpress.org/documentation/article/block-directory/?hsSkipCache=true&output_format=md#respond)󠁿 [Log in to submit feedback](https://login.wordpress.org/?redirect_to=https%3A%2F%2Fwordpress.org%2Fdocumentation%2Farticle%2Fblock-directory%2F&locale=en_US). If you need support with something that wasn't covered by this article, please post your question in the [support forums](https://wordpress.org/support/forums/). First published July 27, 2020 Last updated January 3, 2025