Add docs for useRootPaddingAwareAlignments in theme.json (#43463)

* Add docs for useRootPaddingAwareAlignments in theme.json * Add future release version.
WordPress · Aug 22, 2022 · d4a8898 · d4a8898
1 parent de3dcae
commit d4a8898
Show file tree

Hide file tree

Showing 2 changed files with 20 additions and 0 deletions.
diff --git 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
@@ -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": {