Make use of the API for WordPress Block Bindings to make your blocks more powerful.

Apr 26, 2025

-sidebar-toc> -language-notice>

Displaying custom data displayed in The WordPress Block Editor hasn't always been a simple task. This required the creation of a separate block that could pull information from custom fields, and different sources.

It's a lot of work which can be beyond the reach of certain programming experts. It could be a reason to create duplicate programs. For instance, you could consider showing fields that you have created by using a heading or text. Wouldn't it be feasible without having to create a new block?

This article provides an introduction to Block Bindings API. Block Bindings API, shows you the way it functions by demonstrating it in a basic manner and outlines the potential for what the future holds as the API develops.

The reason Block Bindings API is a groundbreaking instrument

You have to use to utilize register_meta() function register_meta() function or install a plug-in to register and configure new fields. That's just the first step. The display of this information on your website is a different issue.

It is the Block Bindings API brings this capability to WordPress. In addition, there are no plugins that can help you display data. Data sources are tied to a specific block, such as that of the button, Heading, Image, and Paragraph that open up a brand wide range of options for customization for block themes, as well as the use of the Block Editor.

It's not as complete in terms of the features you can create with PHP or utilizing the field plugin that allows customisation. But, it's an initial move towards. This could be all you'll require at times.

A simple use case that makes use of the Block Bindings API

What are the ways that Block Bindings API perform in actual life? Here's a quick example of how it can help.

Before we get started we'll outline the plan we'll follow:

  • You can create a few fields you are able to customize
  • Quote: A famous quote we want to highlight on every page. It is connected by a paragraph block.
  • Photo: The URL of the photo that is displayed on each page. The photo is bound with an Image block.
  • Finally, modify the theme's template for the page and add blocks that are able to retrieve these fields using a custom value.

After we've figured out the plan we can put WordPress Block Bindings API. WordPress Block Bindings API into motion.

Custom fields are possible to enable in the Block Editor

WordPress blocks custom fields by default The first step is to allow them in Block Editor. Block Editor.

To allow custom fields you must open your Settings menu ( icon) in the Block Editor. After that, click Preferences.

After that, select the customized fields toggle to show them within the editor. Select the button to show and reload the page. link to save your modifications.

Enabling custom fields in the Block Editor Preferences screen
Custom fields can be used within the Block Editor

Create custom fields

To register custom fields for us, you need to go to your themes functions.php file. Then, you can add the following code:

// Register custom fields for pages in WordPress using register_meta() function _register_custom_meta_fields_for_pages() // Register the text field "_famous_quote" for pages register_meta('post', '_famous_quote', array( 'type' => 'string', // Text field 'single' => true, // Single value for the field 'sanitize_callback' => 'wp_strip_all_tags', // Sanitize the input 'show_in_rest' => true, // Expose this field in the REST API for Gutenberg )); // Register the image field "_photo" for pages register_meta('post', '_photo', array( 'type' => 'string', // Can store the URL or attachment ID as a string 'single' => true, // Single value for the field 'sanitize_callback' => 'esc_url_raw', // Sanitize the input as a URL 'show_in_rest' => true, // Expose this field in the REST API for Gutenberg )); add_action('init', '_register_custom_meta_fields_for_pages');

Make note of the slugs for each field as we'll need for them later in the section:

  • _famous_quote
  • _photo

The fields can be modified to suit your needs by following the steps within the WordPress register_meta() documentation.

Custom field values can be added on pages

Then, you can include custom field values on the page using these steps:

  1. Navigate to Pages > All Pages then choose the one you want to view.
  2. Find the last section of the page and you will see your field that you have created in the custom panel. Click to click to click the "Enter the new" button below the first field. Add famous quotations in the left column. Add the text of the quote to the right. The future is for those who believe in that beautiful vision of theirs. - Eleanor Roosevelt
  3. Then, click next the button to create a custom Field button in order to generate the "_photo" field. You can enter the URL for the image you want to display to the left.
Custom field values in the WordPress Block Editor
Adding custom fields to WordPress Block Editor. WordPress Block Editor

It is now possible to save the page and duplicate the process for the remaining pages on our site.

The information for the custom field should be arranged into blocks

Click the Editor tab in the Appearance section. After that, click the Templates link in the left column. Look for the templates template, and then click it to start it from within the editor.

The available templates in the WordPress Site Editor
Find the Pages templates within the WordPress Site Editor

First, we need to select a location to display our custom fields. We can add a space on the right side of every page.

In this example it is the case that we'll use the group block as well as insert a column block in it. The left column is populated with the image block (to show our photo) In the right column, we have it's sentence block (to showcase our quote).

We have changed the title of of the group block we made to the Custom Field Data for future references. It is easier to identify if we have to modify it later.

Editing the Pages template in the WordPress Site Editor
By adding blocks, they will show the information from your custom field

It is important to note that the Block Bindings API doesn't have a visual interface for displaying the data at the moment (more on this below). So, we have to modify the codes in the Image and Paragraph blocks. It allows us to connect customized information to them.

Click on the Options menu ( icon) found in the upper left of the Website Editor. Click on the Coding Editor button. It opens the code editor.

Find your Group block that we have recently added. It starts with:

The correct code is appears in the image below.

Viewing a Group block in the Code Editor
We can see our Group block within the Code Editor

Following that, you need to identify the Image and Paragraph blocks within the section. These default codes are following:

Image:

Paragraph:

It is possible to edit the blocks so that they are bindable to custom fields.

Image:

It is crucial to note this amount of crucial value has been in our custom field called _photo. custom field.

Paragraph:

In this case in this instance, in this instance, the key value primary value is associated with the famous_quote customized field.

Make the necessary changes before closing the editor for code.

Click on the Image or Paragraph blocks. WordPress outlines each block in the shade of purple. This indicates that it is bound to a source of data. The left-hand side will show an attributes section that provides more information.

An Image block is bound to a data source
WordPress declares it's true the Image block is linked to a source of data
A Paragraph block is bound to a data source
Our Paragraph block is also linked to various data sources

NOTE: You won't see the blocks when editing pages. These blocks will appear on the upper right-hand side of your page.

This is the last step for accessing the front page of the site. Our image should be displayed along with a quote on pages with custom field values.

WordPress custom field data displayed on a page
The customized fields' data are displayed on the bottom of the page.

Alternative options for binding blocks

The project was a simple illustration of linking blocks to an information source. There are many alternatives for enhancing the design. This includes:

  • Create ALT attributes There is the possibility of having another customized field that defines the ALT attributes of our photographs. This will make the function accessible to more users. As an example it is possible to bind to a new field _photo_alt Then, alt attribute like so:
  • Use a custom data source: These custom fields work perfectly for the needs we have. We could, however, opt to draw information from the customized source. The possibilities include APIs, tables that can be used for customized databases, themes and plugins as well as site information, taxonomies.

It is important to think about the best way to add specific information to your website. Following that, you'll formulate a plan to implement it in a way which is easy to modify. Block Bindings API Block Bindings API provides plenty of options to accomplish this.

Moving forward with using Block Bindings API

Block Bindings API Block Bindings API is not an end-to-end product. It changes in the same way that WordPress launches new versions. WordPress.

As an example, many updates are scheduled for inclusion in WordPress 6.7:

  • An UI that will default to binding blocks to available data sources.
  • Post meta labels for easier to find.
  • Support for custom themes of post types templates.
  • Permissions will be the standard for determining the individual who has the ability to modify bindings of blocks.
  • Numerous technical upgrades beneath the surface of the.

Keep an eye out for updates that make the API easier to use and improve its effectiveness.

You can also install this Gutenberg plugin in order to have access early to new features before they're integrated into WordPress core. It's recommended to install the plugin in a staging or local setting.

Summary

The Block Bindings API represents a change in the way we work using data created by custom in WordPress. This eliminates the requirement for plugins or custom blocks in many instances. It also gives more versatility to WordPress blocks and blocks and block themes.

Integrating it into the workflow of your application can cut down on the time it takes to develop. Since it is a built-in feature improves the performance of your application compared to using plugins.

Those are some big advantages that you can reap today. It is a brighter future!

It's only the beginning of exploring the possibilities described in this article. Explore the API in greater detail Block Bindings API by exploring the possibilities for linking with customized field, working with the source of custom binding and understanding how to identify and change Block Binding values using the editor.

Eric Karkovack

Eric Karkovack is a freelance web developer and a writer who has more than 25 years of experience. He's determined to help other people learn about WordPress freelance jobs and technological advances.

This post was first seen on here