Framework for connecting block attributes to external data sources, allowing dynamic content override during block rendering.

Since: 6.5.0
Source: wp-includes/block-bindings.php, wp-includes/block-bindings/

Components

Registration Flow

init action
    └── register_block_bindings_source()
            └── WP_Block_Bindings_Registry::register()
                    └── new WP_Block_Bindings_Source()

Value Resolution Flow

Block rendering
    └── WP_Block_Bindings_Source::get_value()
            ├── get_value_callback( $source_args, $block_instance, $attribute_name )
            └── apply_filters( 'block_bindings_source_value', $value, ... )

Supported Blocks (Default)

Built-in Sources

Block Markup Example

<!-- wp:paragraph {
  "metadata": {
    "bindings": {
      "content": {
        "source": "my-plugin/my-source",
        "args": {
          "key": "custom_value"
        }
      }
    }
  }
} -->
<p>Fallback text replaced by binding.</p>
<!-- /wp:paragraph -->

Quick Start

// Register a custom source
add_action( 'init', function() {
    register_block_bindings_source( 'my-plugin/site-info', array(
        'label'              => __( 'Site Info', 'my-plugin' ),
        'get_value_callback' => function( $source_args, $block_instance, $attribute_name ) {
            switch ( $source_args['field'] ?? '' ) {
                case 'name':
                    return get_bloginfo( 'name' );
                case 'description':
                    return get_bloginfo( 'description' );
                default:
                    return null;
            }
        },
    ) );
} );