diff --git a/docs/how-to-guides/themes/theme-json.md b/docs/how-to-guides/themes/theme-json.md index c4634acbbbfdc..0eb28f9a29e0e 100644 --- a/docs/how-to-guides/themes/theme-json.md +++ b/docs/how-to-guides/themes/theme-json.md @@ -965,6 +965,15 @@ Currently block variations exist for "header" and "footer" values of the area te } ``` +## Developing with theme.json + +It can be difficult to remember the theme.json settings and properties while you develop, so a JSON scheme was created to help. The schema is available at [SchemaStore.org](https://schemastore.org/) + +To use the schema, add `"$schema": "https://json.schemastore.org/theme-v1.json"` to the beginning of your theme.json file. Visual Studio Code and other editors will pick up the schema and can provide help like tooltips, autocomplete, or schema validation in the editor. + +![Example using validation with schema](https://developer.wordpress.org/files/2021/10/schema-validation.gif) + + ## Frequently Asked Questions ### The naming schema of CSS Custom Properties