WordPress Block Directory: How to Access & Use It

Posted on July 28, 2021 by in WordPress | 5 comments

WordPress Block Directory: How to Access & Use It

If you have ever searched for a specific block in the Gutenberg block editor, then you’ve seen the WordPress Block Directory and may not have even known it. Introduced in version 5.5 and enhanced in WordPress 5.8 with patterns, the Block Directory works very similarly to the theme or plugin repositories at WordPress.org. The difference being this one is built directly into the editor itself for easy access and installation of single blocks. Using the block directory, you can add new features, designs, layouts, and custom blocks to your posts and pages using a single click—all from inside the block editor itself.

How to Access and Search the Block Directory

patterns directory

At its base, the block directory is a repository of block editor extensions and plugins that you can install to enhance the content you create. WordPress 5.8’s release included a new patterns repository as part of the block directory. This repo gives you unprecedented access to design within the WordPress Core backend. Within the plugin repository, you can find a selection of block-enabled plugins. But the main block directory within the editor itself is a list of single-block plugins that you can then install and utilize immediately.

wordpress block directory

While you can absolutely go to the theme and/or patterns directories independently, the big draw is that you can access this conent in the  Gutenberg block editor itself. Simply press the + button to add a block, then begin searching for whatever block you need. If you have the block already installed, it will show up here.

However, if you do not, the next sections of results are from the block directory. After 5.8, the first section of results will be patterns, which are only available to select block styles at first.

Beneath the pattern results are specific blocks that you can install directly from the sidebar directory under the heading Available to Install.

block directory results

These results are based on whatever you used as a search term. At the time of this writing, the results in the block directory itself are somewhat limited. However, as more people add custom blocks and patterns to the directory, the search results will become much more robust.

How to Add a New Block from the Directory

add block

Simply clicking on a block will install it. Additionally, the block appears immediately inside your post. This is an incredibly useful and somewhat aggravating feature, as you can’t click on the block directory entry to expand and read the description or check reviews. You can, however, hover over an entry to see some details such as the star-rating and number of reviews.

ratings

Installing a block via the directory in this manner actually installs and activates the related WordPress plugin. You can find it in the typical place in your admin panel, Plugins – Installed Plugins. Because of block directory guidelines, the only options for these blocks will be in the editor itself.

If you need to uninstall a block plugin for any reason, it’s the same as deactivating and uninstalling any other plugin using your WordPress admin dashboard.

How to Add Your Custom Blocks to the WordPress Block Directory

If you’re a designer or developer, you may want to have your patterns and blocks show up in the directory. Like all of the other WordPress repos, there is a dedicated process for having your block included in the directory. The process is relatively simple, using a single tool for validation, upload, and removal.

Develop a Plugin

The first step is obviously to create your own plugin. Make sure that you follow all of the plugin guidelines for WordPress.org inclusion in the first place. At its base, custom blocks are still plugins. In addition to those guidelines, your plugin must meet the block specific guidelines to be considered for inclusion.

Remember, if you submit to the directory, your plugin must contain only one block. If you are creating a suite of them, you will need to decide whether to include them as a package in the traditional repository or to release them as individual blocks for inclusion here.

Validate and Publish Your Plugin

plugin validator

After you’ve developed your block plugin, you need to validate it. The block plugin checker is a simple tool where you can either upload a .zip file or the URL for the codebase (from SVN, GitHub, or from the plugin repository itself).

If the checker finds issues, you will need to address those before it can be published. If the validator returns a message that it found no problems, you’re ready to push it live. You will use this same tool to publish the block plugin.

You will also use this same tool to remove it from the directory or adjust it as you update the code and functionality.

Conclusion

This is a hidden gem of the new WordPress ecosystem. As a user, adding single, external blocks to content from within the editor is a huge UX enhancement. As a creator, the block directory gives you unprecedented access to users. Before, they had to seek out plugins via the repository. Thanks to the block editor, your creations—for all intents and purposes—seek them out as they search. Hopefully, it won’t take long before more users and developers become aware of and utilize this amazing tool. It is an incredibly powerful tool for everyone involved in WordPress.

What do you think about the WordPress Block Directory? Have you taken advantage of it yet?

Featured Image via Dacian G / shutterstock.com

Premade Layouts

Check Out These Related Posts

How to Use the WordPress Calendar Block

How to Use the WordPress Calendar Block

Posted on September 16, 2021 by in WordPress

Keeping your content organized is an important aspect of running a website. Fortunately, the WordPress Calendar block can help you do that. This element enables you to display a calendar on your site that links to your posts based on their publication dates. As such, your readers won’t need...

View Full Post
How to Use the WordPress Audio Block

How to Use the WordPress Audio Block

Posted on September 15, 2021 by in WordPress

The WordPress Audio Block lets you provide playable audio files within your pages and posts. The audio files can be added from your media library or a URL. Users can play the audio from their browsers or download them to listen offline. This is a great way to provide music, podcasts, or other types...

View Full Post
How to Use the WordPress Cover Block

How to Use the WordPress Cover Block

Posted on September 14, 2021 by in WordPress

The WordPress Cover Block is interesting. It lets you place an image, video, or solid color in the background and add content blocks to the foreground. This means you can place blocks over other blocks. It has more options than most blocks. Knowing how to use the Cover Block can greatly enhance the...

View Full Post

5 Comments

  1. Can I add additional WordPress blocks using any third party plugins?

    • Yes, there are a great number of these. The block directory in this post is predominantly third-party, but they are all individual blocks. If you need multiple blocks in a single plugin, you can check out the Block-Enabled Plugins list on the WP repo: https://wordpress.org/plugins/browse/blocks/

  2. I use very few additional plugins but this certainly seems a good way to be presented the options to do so – that is at the point where they are needed.

  3. If I’m using Divi, which I am and with which I am very haooy, what advantage is there in using Gutenburg?

    • Well, Gutenberg is part of WordPress core. So it’s a good idea to master it along with Divi. Divi is a much more advanced builder at every level–page, post, full site editing. However, you can use WordPress’s editor within Divi and Divi within the WordPress editor.

Leave A Reply

Comments are reviewed and must adhere to our comments policy.

Join To Download Today

Pin It on Pinterest