Trusted WordPress tutorials, when you need them most.
Beginner’s Guide to WordPress
WPB Cup
25 Million+
Websites using our plugins
16+
Years of WordPress experience
3000+
WordPress tutorials
by experts

How to Use the WordPress Block Editor (Gutenberg Tutorial)

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.

How to use the WordPress block editor

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:

Older classic editor in WordPress

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:

Block editor 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.

Table block example

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:

Ready? Let’s dive in.

Video Tutorial

Subscribe to WPBeginner

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.

Add new post in WordPress

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.

The title block

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.

Add new block buttons

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.

Add new block animation

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.

Add new block using keyboard shortcut command

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.

Block toolbar

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.

Additional block settings in the side column

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.

Transform blocks in Groups or Columns

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.

Style group blocks

The block editor also allows you to add an empty Group or Columns block.

After that, you can fill them with other blocks.

Adding a columns block in WordPress

You can add any type of block in each column as needed.

This allows you to create beautiful layouts for different use cases.

Colums block settings

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.

Create reusable block pattern

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.

Create pattern

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.

Insert pattern

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.

Post and page settings in block editor

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.

WPForms block example

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:

All in One SEO settings example

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.

WooCommerce blocks in block editor

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.

Adding image block in WordPress

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.

Image block settings in WordPress

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.

Add link block editor WordPress

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.

Gallery block example

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.

Shortcode block in the block editor

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.

Media and 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.

Buttons in block editor

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.

Cover block

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.

Table block example

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.

Multi column contet block

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.

Move block toolbar to the top

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.’

Use keyboard shortcuts in block editor

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.

Drag ad drop file uploads in block editor

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.

Embed blocks


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.

YouTube embed in block editor

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 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.

2. PublishPress Blocks

PublishPress blocks

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 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.

Convert to blocks

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:

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.

Disclosure: Our content is reader-supported. This means if you click on some of our links, then we may earn a commission. See how WPBeginner is funded, why it matters, and how you can support us. Here's our editorial process.

Editorial Staff

Editorial Staff at WPBeginner is a team of WordPress experts led by Syed Balkhi with over 16 years of experience in WordPress, Web Hosting, eCommerce, SEO, and Marketing. Started in 2009, WPBeginner is now the largest free WordPress resource site in the industry and is often referred to as the Wikipedia for WordPress.

The Ultimate WordPress Toolkit

Get FREE access to our toolkit - a collection of WordPress related products and resources that every professional should have!

Reader Interactions

229 CommentsLeave a Reply

  1. 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

  2. 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.

  3. 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

  4. 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.

  5. 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’?

  6. 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.

  7. 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

  8. 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.

  9. 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

  10. 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

  11. 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

  12. 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

Leave A Reply

Thanks for choosing to leave a comment. Please keep in mind that all comments are moderated according to our comment policy, and your email address will NOT be published. Please Do NOT use keywords in the name field. Let's have a personal and meaningful conversation.