The block editor in WordPress is the default editor for writing content and editing your site. It was introduced in 2019 with the nickname Gutenberg and replaced the old classic editor.
The block editor offers an easy and intuitive way to create content and edit your WordPress site.
In this tutorial, we will show you how to use the WordPress block editor and master it to create visually stunning blog posts and pages.
What’s the Difference Between the Block Editor (Gutenberg) and the Classic Editor?
Before diving into the block editor, let’s compare and understand the differences between the Gutenberg Block Editor and the Older Classic Editor.
Here is what the classic editor in WordPress looked like:
It had a text editor box with some basic formatting options. It was quite limited in functionality and visual appearance.
This is what the block editor looks like in WordPress:
As you can see, they are two completely different editors for creating content in WordPress.
The old classic editor was a text editor with formatting buttons similar to Microsoft Word.
The new editor uses a different approach, called ‘Blocks’ (hence, the name Block Editor).
Blocks are content elements that you can add to the edit screen to create layouts. Each item you add to your post or page is a block.
For example, you can add blocks for paragraphs, images, videos, galleries, audio, lists, and more. There are blocks for all common content elements, and more can be added by WordPress plugins.
How Is the WordPress Block Editor Better Than the Classic Editor?
The WordPress block editor offers a simple way to add different types of content to your posts and pages.
For example, if you previously wanted to add a table to your content using the classic editor, you needed a separate table plugin.
With the block editor, you can simply add a table block, select your columns and rows, and start adding content.
You can move content elements up and down, edit them as individual blocks, and easily create media-rich content.
Most importantly, the WordPress block editor is easy to use and learn.
This gives an immense advantage to all WordPress beginners who are just starting their first blog or building a DIY business website.
That said, let’s examine how to use the WordPress block editor to create great content like a pro.
Here is what we will cover in this Gutenberg tutorial:
- Using Gutenberg – The WordPress Block Editor
- Creating a New Blog Post or Page Using The Block Editor
- How to Add a Block in the Block Editor
- Working With Blocks in the New Editor
- Organizing Blocks in Groups and Columns
- Saving and Reusing Blocks in Gutenberg
- Publishing and Managing Options in Gutenberg Block Editor
- Plugin Settings in Gutenberg
- Adding Some Common Blocks in the Block Editor
- Exploring Other Content Blocks in the Block Editor
- Bonus Tips to Use Gutenberg Like a Pro
- Adding More Blocks to Gutenberg Block Editor in WordPress
- FAQs About Gutenberg – The Block Editor in WordPress
- Bonus Resources
Ready? Let’s dive in.
Video Tutorial
If you’d prefer written instructions, then just keep reading.
Using Gutenberg – The WordPress Block Editor
The block editor is designed to be intuitive and flexible. While it looks different from the old WordPress editor, it still does all the things that you could do in the classic editor.
Let’s start by covering the basic things you did in the classic editor and how they are done in the block editor.
Creating a New Blog Post or Page Using The Block Editor
You will start creating a new blog post or page like you normally would. Simply click on the Posts » Add New Post menu in your WordPress admin. If creating a page, go to the Pages » Add New menu instead.
This will launch the block editor.
How to Add a Block in the Block Editor
The first block of every post or page is the title.
You can use the mouse to move below the title or press the Tab key on your keyboard to move the cursor down and start writing.
By default, the next block is a Paragraph block. This allows users to start writing right away.
However, if you want to add something different, then you can click on the add new block button [+] in the top left corner of the editor, below an existing block, or to the right side of a block.
Clicking on the button will show the add block menu with a search bar on top and commonly used blocks below.
You can click on tabs to browse block categories or type in a keyword to quickly search for a specific block.
If you don’t want to use the mouse to click on the button, then you can also use a keyboard shortcut.
Start by typing / to search for a block and then insert it by pressing the Enter key on your keyboard.
Working With Blocks in the New Editor
Each block has a toolbar that appears on top of it. The buttons in the toolbar change depending on the block you are editing.
For example, in the screenshot below, we are working on a Paragraph block that shows basic formatting buttons like text alignment, bold, italic, insert link, and more options that are available under the three-dot menu.
In addition to the toolbar, each block can have its own block settings, which appear in the right column of the edit screen.
These settings vary depending on which block you are editing. For example, the Paragraph block lets you edit the text, background, and link color, as well as the typography.
You can move blocks up and down and rearrange them.
If you want to do this, just click to drag or drop or click the up and down buttons in the block toolbar.
Related: See our guide on how to remove a block in WordPress.
Organizing Blocks in Groups and Columns
The block editor also comes with handy tools to manage and organize your content layouts.
You can select multiple blocks by clicking on them while pressing the Shift key on your keyboard.
After that, go ahead and click on the block type button in the toolbar to transform the selected blocks into Groups or Columns.
You can then apply styles to the entire Group block, such as changing the alignment or spacing.
The block editor also allows you to add an empty Group or Columns block.
After that, you can fill them with other blocks.
You can add any type of block in each column as needed.
This allows you to create beautiful layouts for different use cases.
Saving and Reusing Blocks in Gutenberg
One of the best things about using blocks is that they can be saved and reused. This is particularly helpful for website owners and bloggers who frequently need to add specific content snippets to their articles or pages.
Simply click the menu button at the right corner of each block’s toolbar. From the menu, select the ‘Create Pattern’ option.
Note: You can also use entire groups and columns as reusable blocks. This allows you to save entire sections and use them whenever needed.
This will bring up a popup where you need to provide a name for this pattern. It can be anything that helps you easily identify when you need to reuse it.
Then, you can optionally choose categories. This helps you sort your patterns in an organized manner.
Next, click on the ‘Create’ button to save your pattern. WordPress will store your pattern with all the blocks inside it.
To reuse your pattern, simply edit the post or page where you want to add it.
Then, click the [+] add block button or use the / keyboard shortcut. You can find the pattern by typing the name you gave it.
Patterns make it easy for site owners to add commonly used elements to their layouts, such as calls to action, social media buttons, banners, and more.
Your WordPress theme or plugins may even come with their own patterns, or you can find patterns created by others in the WordPress Block Patterns library.
If you need more help, we have a separate guide for beginners on finding and using WordPress block patterns.
Publishing and Managing Options in Gutenberg Block Editor
Each WordPress post contains a lot of metadata. This includes information like the publishing date, categories and tags, featured images, and more.
All these options are neatly placed in the right column on the editor screen.
Plugin Options in Gutenberg
WordPress plugins can take advantage of the block editor’s API to integrate their settings within the edit screen.
Some popular plugins come with their own blocks.
For example, WPForms, the best WordPress contact form plugin, allows you to add forms to your content using a block.
Other WordPress plugins may also add their settings to the block editor screen.
For instance, here is how All in One SEO for WordPress allows you to edit your SEO settings at the bottom of the block editor:
Similarly, if you run an online store using WooCommerce, then you’ll notice that it also has its own blocks.
These blocks allow you to add your products to any of your WordPress posts and pages.
Adding Some Common Blocks in the Block Editor
The block editor can do everything the older classic editor did.
However, you will be doing things more quickly and elegantly than before. Plus, it can do much more, like letting you style your content with a bunch of no-code options.
Here are some of the common blocks that you can use.
1. Adding an Image in the WordPress Block Editor
There is a ready-to-use Image block in the WordPress block editor. Simply add the block and then upload an image file or select it from the media library.
You can also drag and drop images from your computer, and the editor will automatically create an Image block.
Once you have added an image, you will be able to see the block settings, where you can add metadata for the image, like the alt text, image resolution size, and adding a link to the image.
For more information, just take a look at our tutorial on how to add images in WordPress.
2. Adding a Link in the Block Editor
The block editor comes with several blocks where you can add text. The most commonly used one is the Paragraph block, which has an insert link button in the toolbar.
All other commonly used text blocks also have a link button in the toolbar.
You can also insert a link using the keyboard shortcut, which is Command + K for Mac and CTRL + K on Windows computers.
3. Adding an Image Gallery in Gutenberg
The Gallery block works like the image block. You add it and then upload or select image files.
For more details, see our guide on creating an image gallery in WordPress.
4. Adding Shortcodes in WordPress Posts Using Gutenberg
All your shortcodes will work just like they did in the classic editor. You can simply add them to a Paragraph block, or you can use the Shortcode block.
Exploring Other Content Blocks in the Block Editor
The Gutenberg editor promised to solve some long-standing usability issues in WordPress by introducing new blocks.
The following are some of the favorites that we believe users will find immensely helpful.
1. Adding an Image Next to Some Text in WordPress
Many of our users could not place an image next to the text using the old editor. You can do this now with the Media & Text block.
This simple block comes with two blocks placed side-by-side, allowing you to easily add an image with some text next to it.
2. Adding a Button in WordPress Posts and Pages
Another annoyance of the old editor was adding a button to your blog posts or pages. You either had to use a plugin that created a shortcode for the button or switch to HTML mode and write code.
Luckily, Gutenberg has a Button block that lets you quickly add a button to any post or page.
You can add a link for your button, change colors, and more. For details, see our article on how to easily add buttons in WordPress.
3. Adding Beautiful Cover Images in Blog Posts and Landing Pages
Another cool feature you may want to try is the Cover block, which allows you to add cover images or color background covers to your posts and pages.
A cover image is a wider image often used for a new section on a page or the beginning of a story. It looks beautiful and allows you to create engaging content layouts.
Simply add a Cover block and then upload the image you want to use. You can choose an overlay color for the cover or make it a fixed background image to create a parallax effect when users scroll down the page.
For more details, see our article on the difference between cover and featured images in WordPress.
4. Creating Tables Inside Articles
The classic editor didn’t have a button to add tables to your WordPress posts. You had to use a plugin or create a table by writing custom CSS and HTML.
Now, the block editor has a default Table block, making adding tables to your posts and pages super easy. Simply add the block and select the number of columns and rows you want to insert.
You can now start adding data to table rows. You can always add more rows and columns if needed, and two basic style options are available.
5. Creating Multi-Column Content
Creating multi-column content was another issue the classic editor didn’t handle at all.
Fortunately, the block editor allows you to add a Columns block, which adds two paragraph block columns.
This column block is quite flexible. You can add up to 6 columns in a row and even use other blocks inside each column.
Bonus Tips to Use Gutenberg Like a Pro
Looking at the block editor, you may wonder whether you will spend more time adding and adjusting blocks than creating actual content.
Well, the block editor is incredibly fast, and even very basic usage for a few minutes will allow you to add blocks instantly without even thinking.
Pretty soon, you will realize how much faster your workflow will become with this approach.
Here are some bonus tips for power users to help you work even faster with the WordPress block editor.
1. Move the Block Toolbar to the Top
You may have noticed in the screenshots above that a toolbar appears at the top of every block. You can move this toolbar to the top of the editor.
To access the ‘Top toolbar’ option, click on the three-dot button at the top right corner of the screen.
2. Use Keyboard Shortcuts
Gutenberg comes with several handy shortcuts that will make your workflow even quicker and easier. The first one you should start using right away is the /.
Simply enter /, start typing, and then the editor will show you matching blocks that you can instantly add.
For more shortcuts, click on the three-dot menu at the top-right corner of your screen and select ‘Keyboard shortcuts.’
This will bring up a popup with a list of all the keyboard shortcuts you can use. The list will have different shortcuts for Windows and Mac users.
3. Drag and Drop Media to Automatically Create Media Blocks
Gutenberg allows you to drag and drop files anywhere on the screen, automatically creating a block for you.
For instance, you can drop a single image or video file, and it will create the block for you. Alternatively, you might drop multiple image files to create a Gallery block.
4. Adding YouTube, Twitter, Vimeo, and Other Embeds
The block editor makes embedding third-party content into your WordPress content easier. There are blocks for all popular third-party services.
However, you can just copy and paste the embed URL at any point, and it will automatically create a block for you.
For example, adding a YouTube video URL will automatically create a YouTube embed block and display the video.
The default embed option will not work for Facebook and Instagram embeds, but there is a workaround. See our article on embedding Facebook and Instagram posts in WordPress.
Adding More Blocks to Gutenberg Block Editor in WordPress
The block editor in WordPress allows developers to create their own blocks. Some excellent WordPress plugins offer block bundles for the new editor.
Here are a few of them:
1. Spectra WordPress Gutenberg Blocks
Spectra WordPress Gutenberg Blocks is a block library with many advanced blocks that help you add more design elements to your content.
Spectra, created by the folks behind the popular Astra WordPress theme, helps you create beautiful designs without writing any code.
For more information, see our complete Spectra review.
PublishPress Blocks is another powerful block library that comes with additional blocks to extend the Gutenberg block editor.
It includes beautiful layout options, sliders, buttons, icons, image galleries, maps, tabs, testimonials, accordions, and more.
3. Stackable – Gutenberg Blocks
Stackable – Gutenberg Blocks is a collection of beautifully designed Gutenberg blocks you can use on your website. It includes blocks for the container, posts, feature grid, accordion, image box, icon list, call to action, and more.
FAQs About Gutenberg – The Block Editor in WordPress
Since Gutenberg became the default WordPress editor, we have been getting a lot of questions about how to use it. Here are the answers to some of the most frequently asked questions about the block editor.
1. What happens to my older posts and pages in the block editor? Can I still edit them?
The block editor does not affect your old posts and pages. You can still edit them, and the block editor will automatically open them in a block containing the classic editor.
You can edit them inside the old editor, or you can convert older articles into blocks and use the block editor.
2. Can I still keep using the old editor?
Yes, you can still keep using the old editor. Simply install and activate the Classic Editor plugin.
Upon activation, the block editor will be disabled, and you will be able to continue using the classic editor.
Please note that the Classic Editor will be supported until 2024. To familiarize yourself with the block editor, start using it now.
3. What do I do if the block editor doesn’t work with a plugin or theme I am using?
Project Gutenberg was long in development, which gave plugin and theme authors plenty of time to test their code for compatibility.
However, there is still a chance that some plugins and themes may not work well with the block editor. In that case, you can install the Classic Editor plugin, request the developer to add Gutenberg support, or find an alternative plugin or theme.
4. How can I learn more about Gutenberg tips and tricks?
WPBeginner is the best place to learn about the block editor in WordPress. We are the largest WordPress resource site on the internet.
We will publish new articles and update our old resources to help you master the block editor.
Meanwhile, if you have any questions, feel free to contact us by leaving a comment or using the contact form on our website.
5. Running into Gutenberg problems?
If you are having trouble with the WordPress block editor, we have created a quick troubleshooting guide that lists all the common block editor problems users encounter and how to fix them.
Bonus Resources
The following are some additional resources that will help you use the block editor more efficiently:
- WordPress Block Editor vs Page Builders: What’s the Difference?
- How to Create a Custom WordPress Block (Easy Way)
- How to Import / Export Your WordPress Gutenberg Blocks (2 Steps)
- WordPress Widgets vs Blocks – What’s the Difference? (Explained)
- A Complete Beginner’s Guide to WordPress Full Site Editing
- Best Block Themes for Full Site Editing in WordPress
We hope this Gutenberg tutorial helped you learn how to use the WordPress block editor. You may also want to see our complete WordPress performance guide for improving your website speed or check out our comparison of the best email marketing services for small businesses.
If you liked this article, then please subscribe to our YouTube Channel for WordPress video tutorials. You can also find us on Twitter and Facebook.
Kzain
I’ve used classic editor but I’m still struggling to get comfortable with this Gutenberg. While it has potential, the design flexibility compared to dedicated page builders like Elementor or SeedProd is quite limited. I find myself constantly looking for workarounds to achieve the desired layout. I hope future updates will bring more design freedom and customization options to the core editor similar to today’s builder but not for posting a post that’s always been better
Oyatogun Oluwaseun Samuel
This is an immensely useful article. I thought I knew block editor well but this article gave me another perspective on how to better use it. I learned for the first time the existence block editor API which can be utilise in plugin development, the grouping of block to create pattern. very useful article.
Dayo Olobayo
I’m curious to see how the block editor continues to develop in the future. I’m hoping that we’ll see even more blocks and features added that will make it even more powerful and versatile. It’s already a great tool, and I can only imagine how it will improve over time.
WPBeginner Support
It will hopefully keep improving over time
Admin
Moinuddin Waheed
Let me take this comment as an opportunity to appreciate the grand old classic editor
which has ruled the wordpress space ever since the wordpress was launched.
Now since we have transitioned to the new edition of gutenburg editor and using it
for making posts and pages, I often miss that old classic editor for its simplicity and ease of use.
I remember recommending my non developer friends to write and post content on
my news website without any training or guide. They used to get familiar with it as soon
as they start using it.
Thanks for this detailed article for steps using gutenburg blocks.
Jiří Vaněk
You speak to my soul, Moinuddin Waheed. I also loved the old WYSIWYG editor and the old concept of the editor. It was simple, worked great, and I just loved it in every way. Then WordPress came with Gutenberg, and for me, that meant a stop. I stopped blogging and didn’t use WordPress for several years because Gutenberg absolutely didn’t suit me. I only returned to WordPress thanks to Elementor, which helped me rediscover some simplicity and intuitive work with WordPress. I started enjoying working with WordPress again. Over time, I’m trying to learn to work with the block editor, but it still feels clunky and unintuitive to me. Unfortunately, it seems we both have to come to terms with that. The good old classic editor as we knew it is unfortunately just history, remembered by only some of us.
Gin
I write my posts in my computer first. Once done I copy it all to the Editor BUT I have to cut and paste each paragraph, into a paragraph block. Is there a way I can copy and paste an article and it ends automatically within ‘blocks’?
WPBeginner Support
We would recommend taking a look at our guide below on copying and pasting into the editor to make the process easier.
https://www.wpbeginner.com/beginners-guide/how-to-copy-and-paste-into-wordpress/
Admin
Sunil Suresh
Wonderful article. I learnt quite a lot about the Gutenberg block editor from your article.
One question: What is the difference between a “pattern” and a “reusable block”? They both seem to be very similar. When would one use one over the other?
WPBeginner Comments
A pattern is a template you can copy and then edit separately each time to use it, whereas a reusable block allows you to change the reusable block and all instances then will update to match.
Melissa
I really don’t know what I’m doing wrong, for some reason the website I’m working on, doesn’t look the same as the website that you can search for. I’m so clueless and really struggling. How does the published site look so different to site I’m still busy editing? I’m so confused…
WPBeginner Support
There are a few possible reasons, if your theme adds many customizations to the design then it could be some confusion from your theme but if you mean your changes are not being applied then it is likely a caching issue.
Admin
Jiří Vaněk
I still think, and am convinced, that Gutenberg does not have the same quality as many external builders. The single and huge advantage of Gutenberg is that it is free and native to the system. And since WordPress itself announced a major improvement of the editor itself, I’m trying to learn to work with Gutenberg, which I didn’t really like from the beginning. These videos help me a lot. I just hope that such work pays off and that one day Gutenberg will be as simple as Seed Prod or Elementor.
Ahmed Omar
actually I am using classic editor which is great for me.
butvi found that some plugins are not working with it.
so, I had to change to block editor which is new for me.
I am following the video step by step which make it easy
thank you
WPBeginner Support
You’re welcome.
Admin
Annabelle Franklin
All I want is something that’s easy to use. The Classic editor has always allowed me to do things easily, e.g. copy and paste text from Word, without needing plugins that are only available to self-hosted sites.
WPBeginner Support
There is a learning curve when anything changes but we hope as the block editor improves you find it more useful
Admin
Annabelle Franklin
Does the Block Editor only work better than the Classic for self-hosted blogs? I can’t afford to pay for a site, and before I start using it I want to make sure it works at least as well as the Classic for people who don’t pay for their Wordpress blog.
WPBeginner Support
It would depend on if there was something that you specifically wanted from the classic editor. If you are just starting out and don’t have experience with either editor then we would recommend using the block editor.
Admin
Ben Eng
How do I enable Gutenberg editor for comments?
WPBeginner Support
The Gutenrberg/Block editor is not currently available for your comments section.
Admin