There are many benefit of working with WordPress. It is a mature platform. Even after its launch of 14 years, WordPress is so relevant as it can adapt as per the project. Now there has been a lots of talk about switching to a new editor called Gutenberg.

As this is a major software change hence you should make sure that your existing plugins and themes will be compatible with this new editor. Gutenberg editor and its code is available as a public plugin in the plugin directory (link). You can download and install it to check its compatibility issues with your WordPress projects.

As many developers and companies are doing WordPress custom plugin development hence it is important for you to know how Gutenberg is going to affect that. Now I will introduce you to the general Gutenberg project. Then I will show you how to test your WordPress projects and make sure they work together fine.

Gutenberg Editor

Introduction to the Gutenberg WordPress Editor Plugin

The Gutenberg plugin is available at Gutenberg is an effort towards building a new standard editor for WordPress. Its goal is to make adding rich contents to WordPress simple and more enjoyable.

Gutenberg is mainly released for the testing purposes as it is still in beta and developers are contributing and updating the project regularly.

This editor focuses to ease the process of formatting of content. Its main feature is a drag and drop interface for formatting pages and posts and you can use an insert drop down to add blocks like text, galleries, elements like headings and lists, widgets, buttons and much more. Right now the goal of WordPress is to make Gutenberg the standard editor by WordPress 5.0. Before that you have to check its compatibility with your plugins and themes.

In Gutenberg interface the common elements like text and images get a quick menu in your content. You can also use the insert-drop-down to display additional content directly within your post:

Gutenberg Editor for WordPress CMS

Till now you must have become more familiar with the Gutenberg approach for content writing. Now I will discuss about the types of content which is required to make the projects compatible with it.

Testing your Plugins with the Gutenberg Editor

Gutenberg can be installed though the WordPress dashboard just like any other plugin. You should have a browser like Chrome with a code inspector. Make sure you install Gutenberg only on local installations as Gutenberg is not ready for live sites. Now I will discuss about the three key points.

Checking for Proper Shortcode Output

Shortcodes are an important part of WordPress. Shortcodes are pre-designed blocks of code having small text with square brackets. For e.g. [example]. They are simple textual representation of blocks of code, the Gutenberg editor will replace them with native editor blocks. Hence you don’t need to remember and use many shortcodes as you can use the Insert drop-down to add the same functionality. WordPress is not going to discontinue support for shortcodes hence it a better to check for any unexpected output and use them into native Gutenberg blocks.

For this step, open the Gutenberg editor and add the shortcode you want to test into a text block. After that save and preview the post to check for any issues and solve them.

Some new templates are also available which can turn shortcode like content into Gutenberg blocks. If you do this integration now then most probably your plugin will be supported by the time Gutenberg will be fully integrated into WordPress. Hence you should begin this process now.

Testing Custom Media Output

Gutenberg has brought a big change in the way it handles each piece of content but still it will work with most of the plugins. Still you should check the compatibility issues of Gutenberg with your plugin if your plugin inserts some custom media within posts or pages. This is important as the quality of your website and user experience depends on how the media is displayed on the front end.

If you want to test this then create a new post in Gutenberg. Make sure your media plugin is activated and works with other normal posts and pages. After that view the page to check the output generated by Gutenberg. Change layouts that include your custom media and check for any issues on the front end. Some of the issues which can arise are: resizing issues, alt text or captions of images not displaying etc. Then you can resolve these issues. Hence by this way you can test your front end for the changes coming due to Gutenberg.

View Gutenberg content in Custom Templates

As Gutenberg is a new content engine hence it may interact differently with your current page layouts. If you are developing themes or plugins which have default styling for pages then you must check this.

You should follow the development of Gutenberg as this is in beta and there will be many changes in future which may affect the output of any custom template made by your WordPress plugins and themes. Gutenberg main aim is to make amazing page layouts simpler but it can also create compatibility issues with older solutions.

If your theme depends on custom templates then you should check how they are working. This can be done by setting a Gutenberg page which loads them automatically. If you are unable to resolve the issues within your own plugin or theme then you can leave a report on the official Gutenberg GitHub project which will help in resolving these issues before it is merged into the WordPress core.


WordPress is being improved continuously hence the developers should be very active to stay up to date. They should write and maintain the code that works even when changes happening. Gutenberg editor will be added in near future hence you should test your themes and plugins with it to resolve the issues before it is finally launched.

Three steps which we have discussed here to test your plugin with Gutenberg editor are:- Checking for proper shortcode output, testing media outputs for any issues and then viewing Gutenberg content in custom templates to make sure they look perfectly.

Author Bio:

Sophia Phillips has been working as a professional in WordPrax Ltd., WordPress website development company and loves sharing information about leveraging multiple benefits of WordPress CMS in the best possible manner. Currently, she has an impressive count of WordPress development-related articles under her name.