From d4a889803f414c98c6a9403bc243cc664890e549 Mon Sep 17 00:00:00 2001
From: tellthemachines <tellthemachines@users.noreply.github.com>
Date: Mon, 22 Aug 2022 17:06:03 +1000
Subject: [PATCH] Add docs for useRootPaddingAwareAlignments in theme.json
 (#43463)

* Add docs for useRootPaddingAwareAlignments in theme.json

* Add future release version.
---
 .../theme-json-reference/theme-json-living.md         | 11 +++++++++++
 schemas/json/theme.json                               |  9 +++++++++
 2 files changed, 20 insertions(+)

diff --git a/docs/reference-guides/theme-json-reference/theme-json-living.md b/docs/reference-guides/theme-json-reference/theme-json-living.md
index fdbf14d6b9379b..7c9b7f75da5d45 100644
--- a/docs/reference-guides/theme-json-reference/theme-json-living.md
+++ b/docs/reference-guides/theme-json-reference/theme-json-living.md
@@ -26,6 +26,17 @@ Setting that enables the following UI tools:
 - typography: lineHeight
 
 
+---
+
+### useRootPaddingAwareAlignments
+
+_**Note:** Since WordPress 6.1._
+
+Enables root padding (the values from `styles.spacing.padding`) to be applied to the contents of full-width blocks instead of the root block.
+
+Please note that when using this setting, `styles.spacing.padding` should always be set as an object with `top`, `right`, `bottom`, `left` values declared separately.
+
+
 ---
 
 ### border
diff --git a/schemas/json/theme.json b/schemas/json/theme.json
index 9fef064661d058..b177bbf8af3e06 100644
--- a/schemas/json/theme.json
+++ b/schemas/json/theme.json
@@ -16,6 +16,15 @@
 				}
 			}
 		},
+		"settingsPropertiesUseRootPaddingAwareAlignments": {
+			"properties": {
+				"useRootPaddingAwareAlignments": {
+					"description": "_**Note:** Since WordPress 6.1._\n\nEnables root padding (the values from `styles.spacing.padding`) to be applied to the contents of full-width blocks instead of the root block.\n\nPlease note that when using this setting, `styles.spacing.padding` should always be set as an object with `top`, `right`, `bottom`, `left` values declared separately.",
+					"type": "boolean",
+					"default": false
+				}
+			}
+		},
 		"settingsPropertiesBorder": {
 			"properties": {
 				"border": {