Block support: Add anchor support for dynamic blocks

WordPress · t-hamano · Dec 25, 2025 · Dec 23, 2025 · Dec 23, 2025 · Dec 24, 2025
commit ade13f4bc600c74ddcbd3941912ec853a47afe6c
@@ -75,7 +75,7 @@ function Edit( { attributes } ) {
 -   Type: `boolean`
 -   Default value: `false`
 
-Anchors let you link directly to a specific block on a page. This property adds a field to define an id for the block and a button to copy the direct link. _Important: It doesn't work with dynamic blocks yet._
+Anchors let you link directly to a specific block on a page. This property adds a field to define an id for the block and a button to copy the direct link.
 
 ```js
 // Declare support for anchor links.

@@ -0,0 +1,64 @@
+<?php
+/**
+ * Anchor block support flag.
+ *
+ * @package gutenberg
+ */
+
+/**
+ * Registers the anchor block attribute for block types that support it.
+ *
+ * @param WP_Block_Type $block_type Block Type.
+ */
+function gutenberg_register_anchor_support( $block_type ) {
+	$has_anchor_support = block_has_support( $block_type, array( 'anchor' ), false );
+
+	if ( ! $has_anchor_support ) {
+		return;
+	}
+
+	if ( ! $block_type->attributes ) {
+		$block_type->attributes = array();
+	}
+
+	if ( ! array_key_exists( 'anchor', $block_type->attributes ) ) {
+		$block_type->attributes['anchor'] = array(
+			'type' => 'string',
+		);
+	}
+}
+
+/**
+ * Add the anchor id to the output.
+ *
+ * @param WP_Block_Type $block_type Block Type.
+ * @param array         $block_attributes Block attributes.
+ *
+ * @return array Block anchor id.
+ */
+function gutenberg_apply_anchor_support( $block_type, $block_attributes ) {
+	if ( ! $block_attributes ) {
+		return array();
+	}
+
+	$has_anchor_support = block_has_support( $block_type, array( 'anchor' ), false );
+	if ( ! $has_anchor_support ) {
+		return array();
+	}
+
+	$has_anchor = array_key_exists( 'anchor', $block_attributes );
+	if ( ! $has_anchor || empty( $block_attributes['anchor'] ) ) {
+		return array();
+	}
+
+	return array( 'id' => $block_attributes['anchor'] );
+}
+
+// Register the block support.
+WP_Block_Supports::get_instance()->register(
+	'anchor',
+	array(
+		'register_attribute' => 'gutenberg_register_anchor_support',
+		'apply'              => 'gutenberg_apply_anchor_support',
+	)
+);
@@ -186,6 +186,7 @@ function gutenberg_is_experiment_enabled( $name ) {
 require __DIR__ . '/block-supports/background.php';
 require __DIR__ . '/block-supports/block-style-variations.php';
 require __DIR__ . '/block-supports/aria-label.php';
+require __DIR__ . '/block-supports/anchor.php';
 require __DIR__ . '/block-supports/block-visibility.php';
 
 // Client-side media processing.

@@ -25,6 +25,7 @@
 		}
 	},
 	"supports": {
+		"anchor": true,
 		"align": true,
 		"__experimentalBorder": {
 			"radius": true,

@@ -25,6 +25,7 @@
 	},
 	"usesContext": [ "postType", "postId", "commentId" ],
 	"supports": {
+		"anchor": true,
 		"html": false,
 		"align": true,
 		"alignWide": false,

@@ -30,6 +30,7 @@
 	},
 	"usesContext": [ "postId", "postType", "templateSlug" ],
 	"supports": {
+		"anchor": true,
 		"html": false,
 		"align": [ "wide", "full" ],
 		"spacing": {

@@ -16,6 +16,7 @@
 		}
 	},
 	"supports": {
+		"anchor": true,
 		"align": true,
 		"html": false,
 		"color": {

@@ -43,6 +43,7 @@
 	},
 	"usesContext": [ "enhancedPagination" ],
 	"supports": {
+		"anchor": true,
 		"align": true,
 		"html": false,
 		"spacing": {

@@ -19,6 +19,7 @@
 	},
 	"usesContext": [ "commentId" ],
 	"supports": {
+		"anchor": true,
 		"html": false,
 		"spacing": {
 			"margin": true,

@@ -14,6 +14,7 @@
 		}
 	},
 	"supports": {
+		"anchor": true,
 		"color": {
 			"gradients": true,
 			"link": true,

@@ -18,6 +18,7 @@
 	},
 	"usesContext": [ "commentId" ],
 	"supports": {
+		"anchor": true,
 		"html": false,
 		"color": {
 			"gradients": true,

@@ -18,6 +18,7 @@
 		}
 	},
 	"supports": {
+		"anchor": true,
 		"html": false,
 		"color": {
 			"link": true,

@@ -14,6 +14,7 @@
 		}
 	},
 	"supports": {
+		"anchor": true,
 		"color": {
 			"gradients": true,
 			"link": true,

@@ -9,6 +9,7 @@
 	"textdomain": "default",
 	"usesContext": [ "postId" ],
 	"supports": {
+		"anchor": true,
 		"align": true,
 		"html": false,
 		"reusable": false,

@@ -14,6 +14,7 @@
 	},
 	"usesContext": [ "postId", "comments/paginationArrow" ],
 	"supports": {
+		"anchor": true,
 		"reusable": false,
 		"html": false,
 		"color": {

@@ -9,6 +9,7 @@
 	"textdomain": "default",
 	"usesContext": [ "postId" ],
 	"supports": {
+		"anchor": true,
 		"reusable": false,
 		"html": false,
 		"color": {

@@ -14,6 +14,7 @@
 	},
 	"usesContext": [ "postId", "comments/paginationArrow" ],
 	"supports": {
+		"anchor": true,
 		"reusable": false,
 		"html": false,
 		"color": {

@@ -27,6 +27,7 @@
 		"comments/paginationArrow": "paginationArrow"
 	},
 	"supports": {
+		"anchor": true,
 		"align": true,
 		"reusable": false,
 		"html": false,

@@ -29,7 +29,7 @@
 		}
 	},
 	"supports": {
-		"anchor": false,
+		"anchor": true,
 		"align": true,
 		"html": false,
 		"__experimentalBorder": {

@@ -17,6 +17,7 @@
 		}
 	},
 	"supports": {
+		"anchor": true,
 		"align": [ "wide", "full" ],
 		"html": false,
 		"color": {

@@ -41,6 +41,7 @@
 		}
 	},
 	"supports": {
+		"anchor": true,
 		"align": true,
 		"spacing": {
 			"margin": true

@@ -9,6 +9,7 @@
 	"textdomain": "default",
 	"usesContext": [ "postId", "postType" ],
 	"supports": {
+		"anchor": true,
 		"__experimentalBorder": {
 			"radius": true,
 			"color": true,

@@ -23,6 +23,7 @@
 		"style"
 	],
 	"supports": {
+		"anchor": true,
 		"reusable": false,
 		"html": false,
 		"typography": {

@@ -29,6 +29,7 @@
 		}
 	},
 	"supports": {
+		"anchor": true,
 		"align": true,
 		"color": {
 			"gradients": true,

@@ -83,6 +83,7 @@
 		}
 	},
 	"supports": {
+		"anchor": true,
 		"align": true,
 		"html": false,
 		"color": {

@@ -21,6 +21,7 @@
 		"viewportWidth": 350
 	},
 	"supports": {
+		"anchor": true,
 		"className": true,
 		"color": {
 			"background": true,

@@ -8,6 +8,7 @@
 	"keywords": [ "equation", "formula", "latex", "mathematics" ],
 	"textdomain": "default",
 	"supports": {
+		"anchor": true,
 		"html": false,
 		"__experimentalBorder": {
 			"color": true,

@@ -19,6 +19,7 @@
 		}
 	},
 	"supports": {
+		"anchor": true,
 		"customClassName": false,
 		"className": false,
 		"html": false,

@@ -63,6 +63,7 @@
 		"style"
 	],
 	"supports": {
+		"anchor": true,
 		"reusable": false,
 		"html": false,
 		"__experimentalSlashInserter": true,

@@ -59,6 +59,7 @@
 		"style"
 	],
 	"supports": {
+		"anchor": true,
 		"reusable": false,
 		"html": false,
 		"typography": {

@@ -106,6 +106,7 @@
 		"maxNestingLevel": "maxNestingLevel"
 	},
 	"supports": {
+		"anchor": true,
 		"align": [ "wide", "full" ],
 		"ariaLabel": true,
 		"contentRole": true,

@@ -9,6 +9,7 @@
 	"parent": [ "core/post-content" ],
 	"textdomain": "default",
 	"supports": {
+		"anchor": true,
 		"customClassName": false,
 		"className": false,
 		"html": false,

@@ -41,6 +41,7 @@
 		"openSubmenusOnClick"
 	],
 	"supports": {
+		"anchor": true,
 		"reusable": false,
 		"html": false,
 		"lock": false,

@@ -34,6 +34,7 @@
 		"openSubmenusOnClick"
 	],
 	"supports": {
+		"anchor": true,
 		"reusable": false,
 		"html": false,
 		"typography": {

@@ -16,6 +16,7 @@
 		"viewportWidth": 350
 	},
 	"supports": {
+		"anchor": true,
 		"spacing": {
 			"margin": true,
 			"padding": true

@@ -26,6 +26,7 @@
 		"viewportWidth": 350
 	},
 	"supports": {
+		"anchor": true,
 		"html": false,
 		"spacing": {
 			"margin": true,

@@ -37,6 +37,7 @@
 	},
 	"usesContext": [ "postType", "postId", "queryId" ],
 	"supports": {
+		"anchor": true,
 		"html": false,
 		"spacing": {
 			"margin": true,

@@ -16,6 +16,7 @@
 		"viewportWidth": 350
 	},
 	"supports": {
+		"anchor": true,
 		"html": false,
 		"color": {
 			"gradients": true,

@@ -13,6 +13,7 @@
 	},
 	"usesContext": [ "postId", "postType" ],
 	"supports": {
+		"anchor": true,
 		"html": false,
 		"color": {
 			"gradients": true,

@@ -16,6 +16,7 @@
 		"viewportWidth": 350
 	},
 	"supports": {
+		"anchor": true,
 		"html": false,
 		"color": {
 			"link": true,

@@ -17,6 +17,7 @@
 		"viewportWidth": 350
 	},
 	"supports": {
+		"anchor": true,
 		"align": [ "wide", "full" ],
 		"html": false,
 		"layout": true,

@@ -28,6 +28,7 @@
 		"viewportWidth": 350
 	},
 	"supports": {
+		"anchor": true,
 		"html": false,
 		"color": {
 			"gradients": true,