ClickCease Custom Gutenberg Block Simple Tutorial

Easy Way to Create a Custom Gutenberg Block

Our related services

After Gutenberg’s release in 2018, most WordPressWordPressOpen-source content management system (CMS) that allows users to create and manage websites and blogs.
More About WordPress
site owners started to use the updated advanced content editorEditorThe interface that allows you to write and format text, add images, embed media, and much more.
More About Editor
on their sites. The content creation gets faster and easier when you use ready-made blocks to manage headings, paragraphs, texts, visuals, galleries, and other content types your blog posts may feature. Gutenberg ships with a series of default blocks that you may use while writing your piece. However, sometimes you need more than what the default settings offer. This is when the knowledge on creating custom GutenbergGutenbergA block-based editor for WordPress.
More About Gutenberg
blocks comes in handy for you. If you look for simple step-by-step instructions on how to create custom Gutenberg blocks for content editing on your site, then you’ve reached the right place. If you are somewhat familiar with HTMLHTMLThe fundamental language used to create and structure content on web pages.
More About HTML
and CSS, the following guidelines will come in handy for you. 

Installing Block Lab

To get started, you need to download and install the Block Lab plugin that we’ll use to create custom Gutenberg blocks for your WordPress admin panel.  

Adding New Block

In the steps described further in this tutorial, we’ll give you step-by-step guidelines on how to create a custom Gutenberg block to reveal testimonials on your site. 

To create a new block, in the left sidebarSidebarA vertical column that appears alongside the main content, providing additional information, links, or widgets that are relevant to the main content.
More About Sidebar
of your WordPress dashboard, click on Block Lab > Add New, and enter any name for your custom block. 

On this page, you need to give a name to your block. You can write any name of your choice in the “Enter block name here” textbox, let’s call it “Testimonials.”

In the block properties in the right sidebar of the page, you can set a custom icon for your block and choose a block category in the Category dropdown box. The slug field will be automatically filled based on the block’s name. To make your block easily found in the WordPress Gutenberg dashboard, make sure the name of the custom Gutenberg block doesn’t feature more than three keywordsKeywordsA specific word or phrase that encapsulates the essence of a particular topic or theme.
More About Keywords

properties of custom Gutenberg block

You can also add different types of fields to your custom block, including text, email, URL, color, image, checkbox, radio buttons, etc. 

To add a new field to your custom Gutenberg block, click on the + Add Field button. 

Each field features several tabs that you need to fill with custom details. The fields include:

  • Field Label – enter any name for the field label;
  • Field Name – it’s automatically generated based on the field label, ensure that you make it unique and easy to remember;
  • Field Type – there are several pre-defined field types that you can choose from the dropdown menu; let’s choose Image;  
  • Field Location – decide whether you want the field to be added to the editor or the inspector;
  • Help Text – add some text to describe your field. 

Click on the Close Field button once you finish editing the custom field. 

Besides adding the Image field type, let’s add two more fields to the testimonials custom Gutenberg block.

You can reorder fields in the drag-and-drop mode. You can also edit or delete them while simply hovering your mouse over the selected field label. Once you finish, click on the publish button to save the changes you’ve applied to the custom Gutenberg block.

Create a Block Template

Creating a custom Gutenberg block is not enough if you want to get it added to your site. You need to create a block templateTemplateA website template is a pre-designed webpage that is a starting point for creating a website.
More About Template
and upload it to the theme folder. We’ll create the block-testimonials.php block template file.

Based on the details provided in the custom block template, the pluginPluginA piece of software that can be easily installed and activated on a CMS platform to enhance its capabilities.
More About Plugin
will learn how to display your block fields inside the Gutenberg editor.

To create the block’s template file, take the following steps. 

Create a folder on your PC and name it blocks. Create the block template file inside this folder and upload it to the directory of the theme you currently use on your WordPress site. Use Notepad or another plain text editorText EditorA software application or program designed for creating, editing, and manipulating plain text files.
More About Text Editor
for creating the template file.  

Whenever you add a new field to your custom Gutenberg block, ensure that you add the following PHPPHPHypertext Preprocessor is a programming language primarily used for web development.
More About PHP
code to the block template file: 

<?php block_field( 'add-your-field-name-here' ); ?>

Do not forget to replace add-your-field-name-here with the field name.

If you use the reviewer-image as the name of the first field, you need to add the following line of code to the template file:

<?php block_field( 'reviewer-image' ); ?>

Do the same for the remaining fields:

<?php block_field( 'reviewer-image' ); ?>

<?php block_field( 'reviewer-name' ); ?>

<?php block_field( 'testimonial-text' ); ?>

Now you need to style the block by adding HTML tags to the above code.

If you want to wrap the reviewer image inside the img tag, you need to add the following code to the block template file:  

<div class="testimonial-block clearfix">

	<div class="testimonial-image">
		<img src ="<?php block_field( 'reviewer-image' ); ?>">

	<div class="testimonial-box">
		<h4><?php block_field( 'reviewer-name' ); ?></h4>
		<p><?php block_field( 'testimonial-text' ); ?></p>


Name the file as block-testimonials.php and save it inside the blocks folder.

Custom Block Styling

To add some styling to your custom Gutenberg block, open a plain Notepad file and add the following code to it.

.testimonial-block {
	width: 100%;
	margin-bottom: 25px;

.testimonial-image {
	float: left;
	width: 25%;
	padding-right: 15px;

.testimonial-box {
	float: left;
	width: 75%;

.clearfix::after {
	content: "";
	clear: both;
	display: table;

Save the file as  block-testimonials.css inside the blocks folder.

Upload the Template File to Theme Folder

To upload the custom block template file to your current WordPress themeWordPress ThemeA collection of files that determines a website’s overall design and functionality.
More About WordPress Theme
, you need to use an FTP file to connect to your site. Once done, navigate to the /wp-content/themes/ folder to open your current theme folder. 

Once you’re connected, go to the /wp-content/themes/ folder. From here you need to open your current theme folder.

Upload the blocks folder with the block template file and CSSCSSCascading Style Sheets is a coding language that determines the appearance and layout of a website.
More About CSS
file provided above to the theme directory. 

Once you complete all these steps, go ahead and test how your custom Gutenberg block works. Click on Pages > Add New > Add Block and search for the Testimonials block. Preview how the block looks like on your site, edit and publish it to let your customers access it.

Let’s discuss your project
Get quote
More Articles by Topic
WordPress powers over 455 million websites worldwide. When it comes to ecommerce, many potential site owners wonder, “Is WordPress secure…
There are many content management systems available. However, not all of them let you create a fully functional ecommerce website.…
An ecommerce website launch is a logical step most businesses take after creating a stunning product or service. However, after…


Feel free to reach out! We are excited to begin our collaboration!
Alex Osmichenko
Business Consultant
Reviewed on Clutch

Send a Project Brief

Fill out and send a form. Our Advisor Team will contact you promptly!

    Note: We will not spam you and your contact information will not be shared.