How to Create a Custom WordPress Block (Easy Way)

Do you wish to produce a personalized Gutenberg block for your WordPress internet site?

While WordPress includes a great deal of standard blocks for producing web content, you could require something much more custom-made for your internet site.

In this write-up, we’ll reveal you a very easy method to produce custom-made Gutenberg obstructs for your WordPress website.

Why Produce a Custom-made WordPress Block?

WordPress includes an instinctive obstruct editor that permits you to quickly produce your blog posts as well as web pages by including web content as well as format aspects as blocks.

By default, WordPress ships with a number of generally utilized blocks. WordPress plugins might additionally include their very own blocks that you can utilize.

Nevertheless, often you might wish to produce your very own custom-made block to do something particular, as well as can’t locate a obstructs plugin that helps you.

In this tutorial, we’ll reveal you exactly how to produce a totally custom-made block.

Note: This write-up is for intermediate individuals. You’ll require to be knowledgeable about HTML as well as CSS to produce custom-made Gutenberg obstructs.

Action 1: Start with Your Initial Customized Block

Initially, you require to set up as well as trigger the Genesis Customized Blocks plugin. For even more information, see our detailed overview on exactly how to set up a WordPress plugin.

Developed by the people behind the prominent Genesis Style Structure as well as StudioPress, this plugin offers programmers very easy devices to rapidly produce custom-made blocks for their tasks.

For this tutorial, we will certainly develop a ‘endorsements’ block.

Initially, head over to Customized Blocks » Include New web page from the left sidebar of your admin panel.

Creating a new custom block

This will certainly bring you to the Block Editor web page.

From right here, you require to offer a name to your block.

Block name

On the best side of the web page, you’ll locate the block residential properties.

Right here you can select a symbol for your block, include a group, as well as include keyword phrases.

Configure block settings

The slug will certainly be auto-filled based upon your block’s name, so you don’t need to alter it. Nevertheless, you might write to 3 keyword phrases in the Keywords message area to ensure that your block can be quickly discovered.

Currently allow’s include some areas to our block.

You can include various kinds of areas like message, numbers, e-mail address, LINK, shade, picture, checkbox, radio switches, as well as a lot more.

We’ll include 3 areas to our custom-made testimonial block: a picture area for the picture of the customer, a textbox for the customer name, as well as a message location field for the testimonial message.

Click the [+] Include Area switch to put the initial area.

Add block field

This will certainly open some choices for the area. Allow’s have a look at each of them.

  • Area Tag: You can utilize any kind of name of your selection for the area tag. Allow’s call our initial area ‘Customer Picture’.
  • Area Call: The area name will certainly be created instantly based upon the area tag. We’ll utilize this area name in the following action, so see to it it’s special for each area.
  • Area Kind: Right here you can choose the kind of area. We desire our initial area to be a picture, so we’ll choose Picture from the dropdown food selection.
  • Area Place: You can determine whether you wish to include the area to the editor or the assessor.
  • Assist Text: You can include some message to define the area. This is not needed if you’re producing this block for your individual usage, yet might be practical for multi-author blog sites.

You might additionally obtain some extra choices based upon the area kind you select. As an example, if you choose a message area, after that you’ll obtain added choices like placeholder message as well as personality limitation.

Complying with the above procedure, allow’s include 2 various other areas for our endorsements obstruct by clicking the [+] Include Area switch.

In situation you wish to reorder the areas, after that you can do that by dragging them utilizing the deal with on the left side of each area tag.

To modify or remove a specific area, you require to click the area tag as well as modify the choices in the best column.

Publish block

As Soon As you’re done, click the Publish switch, existing on the best side of the web page, to conserve your custom-made Gutenberg block.

Action 2: Produce a Custom-made Block Layout

Although you’ve produced the custom-made WordPress block in the last action, it won’t function up until you produce a block theme.

The block theme figures out precisely just how the info participated in the block is shown on your internet site. You reach determine exactly how it looks by utilizing HTML as well as CSS, or perhaps PHP code if you require to run features or do various other innovative points with the information.

There are 2 means to produce a block theme. If your block result remains in HTML/CSS, after that you can utilize the integrated theme editor.

On the various other hand, if your block result needs some PHP to run in the history, after that you’ll require to by hand produce a block theme data as well as upload it to your motif folder.

Approach 1. Making Use Of Integrated Layout Editor

On the custom-made block modify display just switch over to the Theme Editor tab as well as enter your HTML under the markup tab.

Block template editor

You can create your HTML as well as utilize dual curly braces to put block area worths.

As an example, we utilized the complying with HTML for the example block we produced above.

<div course="testimonial-item">
<img src="{{reviewer-image}}" course="reviewer-image">
<h4 course="reviewer-name">{{reviewer-name}}</h4>
<div course="testimonial-text">{{testimonial-text}}</div>

Afterwards, switch over to the CSS tab to design your block result markup.

Enter your block template CSS

Right here is the example CSS we utilized for our custom-made block.

.reviewer-name { 

.reviewer-image {
    float: left;
    cushioning: 0px;
    boundary: 5px strong #eee;
    max-width: 100px;
    max-height: 100px;
    border-radius: 50%;
    margin: 10px;

.testimonial-text {

.testimonial-item { 
 border-bottom:1px strong #eee;

Approach 2. By Hand Posting Customized Block Templates

This approach is suggested if you require to utilize PHP to connect with your custom-made block areas.

You’ll generally require to publish the editor theme straight to your motif.

Initially, you require to produce a folder on your computer system name it with your custom-made block name slug. As an example, our demonstration block is called Endorsements so we’ll produce an endorsements folder.

Block template folder

Following, you require to produce a data called block.php utilizing a simple message editor. This is where you’ll place the HTML / PHP component of your block theme.

Right here is the example theme we utilized for our instance.

<div course="testimonial-item <?php block_field('className'); ?>">
<img class="reviewer-image" src="<?php block_field( 'reviewer-image' ); ?>" alt="<?php block_field( 'reviewer-name' ); ?>" />
<h4 class="reviewer-name"><?php block_field( 'reviewer-name' ); ?></h4>
<div class="testimonial-text"><?php block_field( 'testimonial-text' ); ?></div>

Notice how we used the block_field() function to fetch data from a block field.

We have wrapped our block fields in the HTML we want to use to display the block. We have also added CSS classes so that we can style the block properly.

Don’t forget to save the file inside the folder you created earlier.

Next, you need to create another file using the plain text editor on your computer and save it as block.css inside the folder you created.

We’ll use this file to add CSS needed to style our block display. Here is the sample CSS we used for this example.

.reviewer-name { 

.reviewer-image {
    float: left;
    padding: 0px;
    border: 5px solid #eee;
    max-width: 100px;
    max-height: 100px;
    border-radius: 50%;
    margin: 10px;

.testimonial-text {

.testimonial-item { 
 border-bottom:1px solid #eee;

Don’t forget to save your changes.

Your block template folder will now have two template files inside it.

block template files

After that, you need to upload your block folder to your website using an FTP client or the File Manager app inside your WordPress hosting account’s control panel.

Once connected, navigate to the /wp-content/themes/your-current-theme/ folder.

If your theme folder doesn’t have a folder name blocks, then go ahead and create a new directory and name it blocks.

Create blocks folder inside your WordPress theme folder

Now enter the blocks folder and upload the folder you created on your computer to the blocks folder.

Uploaad block template files

That’s all! You have successfully created manual template files for your custom block.

Step 3. Preview Your Custom Block

Now, before you can preview your HTML/CSS, you need to provide some test data that can be used to display a sample output.

Inside the WordPress admin area edit your block and switch to the Editor Preview tab. Here, you need to enter some dummy data.

Editor preview

Don’t forget to click on the Update button to save your changes before your can preview.

Save your template changes

You can now switch to the Front-end Preview tab to see how your block will look on the front-end (public area of your WordPress website).

Front-end preview of your website

If everything looks good to you, then you can update your block to save any unsaved changes.

Step 4. Using Your Custom Block in WordPress

You can now use your custom block in WordPress like you would use any other blocks.

Simply edit any post or page where you want to use this block.

Click on the add new block button and search for your block by typing its name or keywords.

Inseting custom block in posts and pages

After you insert the block to the content area, you’ll see the block fields you created for this custom block.

Block fields preview

You can fill out the block fields as needed.

As you move away from the block to another block, the editor will automatically show a live preview of your block.

Block preview inside the block editor

You can now save your post and page and preview it to see your custom block in action on your website.

Here’s how the testimonials block looks on our test site.

Custom block live preview

We hope this article helped you learn how to easily create custom Gutenberg blocks for your WordPress website.

You may also want to see our guide on how to create a custom WordPress theme from scratch, or see our expert pick of the must have WordPress plugins for your website.

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.

The post How to Create a Custom WordPress Block (Easy Way) first appeared on WPBeginner.


Please enter your comment!
Please enter your name here

Our Recomendations

More Recipes Like This