Title: theme.json in Classic themes Published: 1 August 2024 Last modified: 6 August 2024 --- [Home](https://learn.wordpress.org)[Courses](https://learn.wordpress.org/courses/) [Intermediate Theme Developer](https://learn.wordpress.org/course/intermediate-theme-developer/) theme.json in Classic themes [ Exit Course ](https://learn.wordpress.org/course/intermediate-theme-developer/) 1. a. [ Global theme settings ](https://learn.wordpress.org/lesson/global-theme-settings/) [Preview](https://learn.wordpress.org/lesson/global-theme-settings/) b. [ Block theme styles ](https://learn.wordpress.org/lesson/block-theme-styles/) [Preview](https://learn.wordpress.org/lesson/block-theme-styles/) c. [ Templates ](https://learn.wordpress.org/lesson/custom-templates/) [Preview](https://learn.wordpress.org/lesson/custom-templates/) d. [ Theme Patterns ](https://learn.wordpress.org/lesson/theme-patterns/) [Preview](https://learn.wordpress.org/lesson/theme-patterns/) e. [ Style Variations ](https://learn.wordpress.org/lesson/style-variations/) [Preview](https://learn.wordpress.org/lesson/style-variations/) 2. 5 lessons 3. a. [ Template overview ](https://learn.wordpress.org/lesson/template-overview/) [Preview](https://learn.wordpress.org/lesson/template-overview/) b. [ Template Hierarchy ](https://learn.wordpress.org/lesson/template-hierarchy/) [Preview](https://learn.wordpress.org/lesson/template-hierarchy/) c. [ Template parts ](https://learn.wordpress.org/lesson/template-parts-4/) [Preview](https://learn.wordpress.org/lesson/template-parts-4/) 4. 3 lessons 5. a. [ Custom functionality ](https://learn.wordpress.org/lesson/custom-functionality/) [Preview](https://learn.wordpress.org/lesson/custom-functionality/) b. [ Including assets ](https://learn.wordpress.org/lesson/including-assets/) [Preview](https://learn.wordpress.org/lesson/including-assets/) c. [ Block stylesheets ](https://learn.wordpress.org/lesson/block-stylesheets/) [Preview](https://learn.wordpress.org/lesson/block-stylesheets/) d. [ Block style variations ](https://learn.wordpress.org/lesson/block-style-variations/) [Preview](https://learn.wordpress.org/lesson/block-style-variations/) e. [ Block variations ](https://learn.wordpress.org/lesson/block-variations/) [Preview](https://learn.wordpress.org/lesson/block-variations/) 6. 5 lessons 7. a. [ Introduction to Classic themes ](https://learn.wordpress.org/lesson/introduction-to-classic-themes/) [Preview](https://learn.wordpress.org/lesson/introduction-to-classic-themes/) b. [ The Loop ](https://learn.wordpress.org/lesson/the-loop/) [Preview](https://learn.wordpress.org/lesson/the-loop/) c. [ Theme options ](https://learn.wordpress.org/lesson/theme-options/) [Preview](https://learn.wordpress.org/lesson/theme-options/) d. [ theme.json in Classic themes ](https://learn.wordpress.org/lesson/theme-json-in-classic-themes/) [Preview](https://learn.wordpress.org/lesson/theme-json-in-classic-themes/) e. [ Converting a Classic theme to a Block theme ](https://learn.wordpress.org/lesson/converting-a-classic-theme-to-a-block-theme/) [Preview](https://learn.wordpress.org/lesson/converting-a-classic-theme-to-a-block-theme/) 8. 5 lessons 9. a. [ Best practices for developing an accessible theme ](https://learn.wordpress.org/lesson/best-practices-for-developing-an-accessible-theme/) [Preview](https://learn.wordpress.org/lesson/best-practices-for-developing-an-accessible-theme/) b. [ Tools for testing theme accessibility ](https://learn.wordpress.org/lesson/tools-for-testing-theme-accessibility/) [Preview](https://learn.wordpress.org/lesson/tools-for-testing-theme-accessibility/) 10. 2 lessons 11. a. [ Themes and user privacy ](https://learn.wordpress.org/lesson/themes-and-user-privacy/) [Preview](https://learn.wordpress.org/lesson/themes-and-user-privacy/) 12. 1 lesson 13. a. [ Child themes ](https://learn.wordpress.org/lesson/child-themes/) [Preview](https://learn.wordpress.org/lesson/child-themes/) b. [ UI Best Practices ](https://learn.wordpress.org/lesson/ui-best-practices/) [Preview](https://learn.wordpress.org/lesson/ui-best-practices/) c. [ JavaScript in Themes ](https://learn.wordpress.org/lesson/javascript-in-themes/) [Preview](https://learn.wordpress.org/lesson/javascript-in-themes/) d. [ Build Process ](https://learn.wordpress.org/lesson/build-process/) [Preview](https://learn.wordpress.org/lesson/build-process/) e. [ Plugin API hooks ](https://learn.wordpress.org/lesson/plugin-api-hooks/) [Preview](https://learn.wordpress.org/lesson/plugin-api-hooks/) f. [ Testing your theme ](https://learn.wordpress.org/lesson/testing-your-theme/) [Preview](https://learn.wordpress.org/lesson/testing-your-theme/) 14. 6 lessons 15. a. [ The WordPress.org Theme Directory ](https://learn.wordpress.org/lesson/the-wordpress-org-theme-directory/) [Preview](https://learn.wordpress.org/lesson/the-wordpress-org-theme-directory/) b. [ Required theme files ](https://learn.wordpress.org/lesson/required-theme-files/) [Preview](https://learn.wordpress.org/lesson/required-theme-files/) c. [ Preparing your theme for submission ](https://learn.wordpress.org/lesson/preparing-your-theme-for-submission/) [Preview](https://learn.wordpress.org/lesson/preparing-your-theme-for-submission/) d. [ Submitting your theme to WordPress.org ](https://learn.wordpress.org/lesson/submitting-your-theme-to-wordpress-org/) [Preview](https://learn.wordpress.org/lesson/submitting-your-theme-to-wordpress-org/) e. [ Updating your theme ](https://learn.wordpress.org/lesson/updating-your-theme/) [Preview](https://learn.wordpress.org/lesson/updating-your-theme/) 16. 5 lessons ### Classic themes # theme.json in Classic themes Welcome to this lesson which explores the option of adding the theme.json file to a classic theme. With this lesson, you will: * you will list the benefits of having theme.json added to a classic theme, and * describe the process of adding theme.json to a classic theme. ## What are the benefits of having theme.json added to a classic theme? Here we have Twenty Twenty-One as the currently active theme. We’ll take a look at some of the settings and styles that are available to the end user by opening up a page. We’ll open the sample page. If we select a block and go over to the right side here, we see there’s text and typography settings and styles available. With theme.json, we can gain control over those settings and styles. For example, you could choose to disable color support for the heading block. Here you’re looking at the code you would add to theme.json in order to disable color support for the heading block. ```wp-block-code { "version": 3, "settings": { "blocks": { "core/heading": { "color": { "text": false, "background": false, "link": false } } } } } ``` ## Adding theme.json Let’s now take a look at adding theme.json to a classic theme. Let’s add theme.json to the Twenty Twenty-One theme. And all we need to get started is the schema and the version. ```wp-block-code { "$schema": "https://schemas.wp.org/trunk/theme.json", "version": 3 } ``` To learn more about adding theme.json to a theme, do check out the _Global settings and styles_ lesson available within the _Beginner WordPress developer learning pathway_. If we go back into WordPress now and reload the page, we see that the layout has shifted. This is because the theme.json that ships with WordPress is now activated. To resolve this issue, go back into theme.json and add the settings for the content size. Add 650px and save those changes, then go back into WordPress and reload again. ```wp-block-code "settings": { "layout": { "contentSize": "650px" } } ``` If you want to see all of the settings within theme.json of WordPress core, you can find it within the _‘wp-includes/theme.json’_ folder. ## Next steps If you would like to learn more about theme.json, you can take a look at the [block editor handbook](https://developer.wordpress.org/block-editor/) available to you on WordPress.org. This is a preview lesson Register or sign in to take this lesson. [ Take course ](https://learn.wordpress.org/course/intermediate-theme-developer/) [ Sign in ](https://login.wordpress.org/?redirect_to=https%3A%2F%2Flearn.wordpress.org%2Flesson%2Ftheme-json-in-classic-themes%2F&locale=en_US) ## Suggestions Found a typo, grammar error or outdated screenshot? [Contact us](https://learn.wordpress.org/report-content-feedback/).