Title: Global Settings and Styles (theme.json)
Author: Justin Tadlock
Published: September 28, 2023
Last modified: December 14, 2023

---

# Global Settings and Styles (theme.json)

Welcome to the Global Settings and Styles documentation. In this chapter you will
learn everything you need to know about configuring settings, styles, and more via
your theme’s `theme.json` file.

`theme.json` is a foundational piece of block theming. While it is not a strictly
required file, you will need to work with it for nearly any theme project. It is
useful for everything from configuring colors to defining default typography settings
to applying front-end styles to your theme.

## Navigating this chapter

Use the below links to find the topic you are looking for in this chapter. Each 
section of the chapter is set up to offer a straightforward learning path toward
learning the ins-and-outs of `theme.json` for first-time themers. But if you are
already familiar with the foundational concepts, feel free to skip ahead to the 
topic you want to learn more about.

 * [**Introduction to `theme.json`**](https://developer.wordpress.org/themes/global-settings-and-styles/introduction-to-theme-json/)**:**
   A walkthrough of setting up your `theme.json` file, introducing you to the foundational
   concepts for configuring global settings and styles for your theme.
 * [**Settings**](https://developer.wordpress.org/themes/global-settings-and-styles/settings/)**:**
   Documentation for each of the standard and custom settings that you can configure
   via `theme.json`. Sub-pages document every available setting.
 * [**Styles**](https://developer.wordpress.org/themes/global-settings-and-styles/styles/)**:**
   Learn how to use the standard design system to apply styles through `theme.json`,
   which also integrate with the user interface.
 * [**Custom Templates**](https://developer.wordpress.org/themes/global-settings-and-styles/custom-templates/)**:**
   How to register custom post, page, and CPT (custom post type) templates for your
   theme.
 * [**Template Parts**](https://developer.wordpress.org/themes/global-settings-and-styles/template-parts/)**:**
   How to register custom template parts that can be reused across your theme.
 * [**Patterns**](https://developer.wordpress.org/themes/global-settings-and-styles/patterns/)**:**
   How to bundle patterns from the official patterns repository with your theme.
 * [**Style Variations**](https://developer.wordpress.org/themes/global-settings-and-styles/style-variations/)**:**
   Documentation on creating custom `theme.json` style variations, giving your users
   alternative designs to choose from.

First published

September 28, 2023

Last updated

December 14, 2023

[  Previous: Global Settings and Styles](https://developer.wordpress.org/themes/core-concepts/global-settings-and-styles/)

[  Next: Introduction to theme.json](https://developer.wordpress.org/themes/global-settings-and-styles/introduction-to-theme-json/)