diff --git a/docs/reference-guides/README.md b/docs/reference-guides/README.md
index 39c6733bbb4fd6..37cc9b8fc77ca5 100644
--- a/docs/reference-guides/README.md
+++ b/docs/reference-guides/README.md
@@ -11,6 +11,7 @@
 -   [Transformations](/docs/reference-guides/block-api/block-transforms.md)
 -   [Templates](/docs/reference-guides/block-api/block-templates.md)
 -   [Metadata](/docs/reference-guides/block-api/block-metadata.md)
+-   [Block Variations](/docs/reference-guides/block-api/block-variations.md)
 -   [Block Patterns](/docs/reference-guides/block-api/block-patterns.md)
 -   [Annotations](/docs/reference-guides/block-api/block-annotations.md)
 -   [Versions](/docs/reference-guides/block-api/versions.md)
diff --git a/docs/reference-guides/block-api/README.md b/docs/reference-guides/block-api/README.md
index 753ba459c89195..7769a442740a78 100644
--- a/docs/reference-guides/block-api/README.md
+++ b/docs/reference-guides/block-api/README.md
@@ -13,6 +13,7 @@ The following sections will walk you through the existing block APIs:
 -   [Transformations](/docs/reference-guides/block-api/block-transforms.md)
 -   [Templates](/docs/reference-guides/block-api/block-templates.md)
 -   [Metadata](/docs/reference-guides/block-api/block-metadata.md)
+-   [Block Variations](/docs/reference-guides/block-api/block-variations.md)
 -   [Block Patterns](/docs/reference-guides/block-api/block-patterns.md)
 -   [Annotations](/docs/reference-guides/block-api/block-annotations.md)
 -   [Versions](/docs/reference-guides/block-api/versions.md)