Title: Theme.json Version 3 Reference (latest)
Published: January 14, 2022
Last modified: September 28, 2026

---

# Theme.json Version 3 Reference (latest)

## In this article

 * [JSON Schema](https://developer.wordpress.org/block-editor/reference-guides/theme-json-reference/theme-json-living/?output_format=md#json-schema)
 * [settings](https://developer.wordpress.org/block-editor/reference-guides/theme-json-reference/theme-json-living/?output_format=md#settings)
    - [useRootPaddingAwareAlignments](https://developer.wordpress.org/block-editor/reference-guides/theme-json-reference/theme-json-living/?output_format=md#userootpaddingawarealignments)
    - [appearanceTools](https://developer.wordpress.org/block-editor/reference-guides/theme-json-reference/theme-json-living/?output_format=md#appearancetools)
    - [background](https://developer.wordpress.org/block-editor/reference-guides/theme-json-reference/theme-json-living/?output_format=md#background)
    - [blockVisibility](https://developer.wordpress.org/block-editor/reference-guides/theme-json-reference/theme-json-living/?output_format=md#blockvisibility)
    - [border](https://developer.wordpress.org/block-editor/reference-guides/theme-json-reference/theme-json-living/?output_format=md#border)
    - [color](https://developer.wordpress.org/block-editor/reference-guides/theme-json-reference/theme-json-living/?output_format=md#color)
    - [dimensions](https://developer.wordpress.org/block-editor/reference-guides/theme-json-reference/theme-json-living/?output_format=md#dimensions)
    - [layout](https://developer.wordpress.org/block-editor/reference-guides/theme-json-reference/theme-json-living/?output_format=md#layout)
    - [lightbox](https://developer.wordpress.org/block-editor/reference-guides/theme-json-reference/theme-json-living/?output_format=md#lightbox)
    - [position](https://developer.wordpress.org/block-editor/reference-guides/theme-json-reference/theme-json-living/?output_format=md#position)
    - [shadow](https://developer.wordpress.org/block-editor/reference-guides/theme-json-reference/theme-json-living/?output_format=md#shadow)
    - [spacing](https://developer.wordpress.org/block-editor/reference-guides/theme-json-reference/theme-json-living/?output_format=md#spacing)
    - [typography](https://developer.wordpress.org/block-editor/reference-guides/theme-json-reference/theme-json-living/?output_format=md#typography)
    - [viewport](https://developer.wordpress.org/block-editor/reference-guides/theme-json-reference/theme-json-living/?output_format=md#viewport)
    - [custom](https://developer.wordpress.org/block-editor/reference-guides/theme-json-reference/theme-json-living/?output_format=md#custom)
 * [styles](https://developer.wordpress.org/block-editor/reference-guides/theme-json-reference/theme-json-living/?output_format=md#styles)
    - [background](https://developer.wordpress.org/block-editor/reference-guides/theme-json-reference/theme-json-living/?output_format=md#background-2)
    - [border](https://developer.wordpress.org/block-editor/reference-guides/theme-json-reference/theme-json-living/?output_format=md#border-2)
    - [color](https://developer.wordpress.org/block-editor/reference-guides/theme-json-reference/theme-json-living/?output_format=md#color-2)
    - [css](https://developer.wordpress.org/block-editor/reference-guides/theme-json-reference/theme-json-living/?output_format=md#css)
    - [dimensions](https://developer.wordpress.org/block-editor/reference-guides/theme-json-reference/theme-json-living/?output_format=md#dimensions-2)
    - [filter](https://developer.wordpress.org/block-editor/reference-guides/theme-json-reference/theme-json-living/?output_format=md#filter)
    - [outline](https://developer.wordpress.org/block-editor/reference-guides/theme-json-reference/theme-json-living/?output_format=md#outline)
    - [shadow](https://developer.wordpress.org/block-editor/reference-guides/theme-json-reference/theme-json-living/?output_format=md#shadow-2)
    - [spacing](https://developer.wordpress.org/block-editor/reference-guides/theme-json-reference/theme-json-living/?output_format=md#spacing-2)
    - [typography](https://developer.wordpress.org/block-editor/reference-guides/theme-json-reference/theme-json-living/?output_format=md#typography-2)
 * [customTemplates](https://developer.wordpress.org/block-editor/reference-guides/theme-json-reference/theme-json-living/?output_format=md#customtemplates)
 * [templateParts](https://developer.wordpress.org/block-editor/reference-guides/theme-json-reference/theme-json-living/?output_format=md#templateparts)
 * [patterns](https://developer.wordpress.org/block-editor/reference-guides/theme-json-reference/theme-json-living/?output_format=md#patterns)

[ Back to top](https://developer.wordpress.org/block-editor/reference-guides/theme-json-reference/theme-json-living/?output_format=md#wp--skip-link--target)

>  This is the living specification for **version 3** of `theme.json`. This version
> works with WordPress 6.6 or later, and the latest Gutenberg plugin.
>  There are some related documents that you may be interested in:
>  – the [theme.json v1](https://developer.wordpress.org/block-editor/reference-guides/theme-json-reference/theme-json-v1/)
> specification, – the [theme.json v2](https://developer.wordpress.org/block-editor/reference-guides/theme-json-reference/theme-json-v2/)
> specification, and – the [reference to migrate from older theme.json versions](https://developer.wordpress.org/block-editor/reference-guides/theme-json-reference/theme-json-migrations/).

This reference guide lists the settings and style properties defined in the `theme.
json` schema. See the [theme.json how to guide](https://developer.wordpress.org/block-editor/how-to-guides/themes/global-settings-and-styles/)
for examples and guidance on how to use the `theme.json` file in your theme.

## 󠀁[JSON Schema](https://developer.wordpress.org/block-editor/reference-guides/theme-json-reference/theme-json-living/?output_format=md#json-schema)󠁿

This documentation was generated from the JSON schema for theme.json.

The latest schema for version 3, including all the latest changes from the Gutenberg
plugin, is available at `https://schemas.wp.org/trunk/theme.json`.

Theme.json schemas for each WordPress version are available at `https://schemas.
wp.org/wp/{{version}}/theme.json`.
 For example, a schema for WordPress 5.8 is available
at `https://schemas.wp.org/wp/5.8/theme.json`.

See [Developing with theme.json](https://developer.wordpress.org/block-editor/how-to-guides/themes/global-settings-and-styles/#developing-with-themejson)
for how to use the JSON schema in your editor.

## 󠀁[settings](https://developer.wordpress.org/block-editor/reference-guides/theme-json-reference/theme-json-living/?output_format=md#settings)󠁿

Settings for the block editor and individual blocks. These include things like:
–
Which customization options should be available to the user. – The default colors,
font sizes… available to the user. – CSS custom properties and class names used 
in styles. – And the default layout of the editor (widths and available alignments).

### 󠀁[useRootPaddingAwareAlignments](https://developer.wordpress.org/block-editor/reference-guides/theme-json-reference/theme-json-living/?output_format=md#userootpaddingawarealignments)󠁿

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.

**Note:** Top-level only property. Not available in blocks.

---

### 󠀁[appearanceTools](https://developer.wordpress.org/block-editor/reference-guides/theme-json-reference/theme-json-living/?output_format=md#appearancetools)󠁿

Setting that enables the following UI tools:

 * background: backgroundImage, backgroundSize
 * border: color, radius, style, width
 * color: link, heading, button, caption
 * dimensions: aspectRatio, height, minHeight, minWidth, width
 * position: sticky
 * spacing: blockGap, margin, padding
 * typography: lineHeight

---

### 󠀁[background](https://developer.wordpress.org/block-editor/reference-guides/theme-json-reference/theme-json-living/?output_format=md#background)󠁿

Settings related to background.

  |  Property |  Description |  Type |  Default |  
   |  backgroundImage |  Allow users to set a background image. |  `boolean` |  `false` |  
 |  backgroundSize |  Allow users to set values related to the size of a background image, including size, position, and repeat controls. |  `boolean` |  `false` |  
 |  gradient |  Allow users to set a gradient background. |  `boolean` |  `false` |  
 |  backgroundClip |  Allow users to set background clip. Pass true for all methods, or an array of CSS values: [“text”, “padding-box”, “border-box”, “content-box”]. |  `boolean`, `[ string ]` |   |

---

### 󠀁[blockVisibility](https://developer.wordpress.org/block-editor/reference-guides/theme-json-reference/theme-json-living/?output_format=md#blockvisibility)󠁿

Settings related to block visibility.

  |  Property |  Description |  Type |  Default |  
   |  allowEditing |  Whether block visibility can be edited in the editor. Set to `false` to hide the block visibility controls. Saved block visibility attributes are always rendered regardless of this setting. |  `boolean` |  `true` |

---

### 󠀁[border](https://developer.wordpress.org/block-editor/reference-guides/theme-json-reference/theme-json-living/?output_format=md#border)󠁿

Settings related to borders.

  |  Property |  Description |  Type |  Default |  
   |  color |  Allow users to set custom border colors. |  `boolean` |  `false` |  
 |  radius |  Allow users to set custom border radius. |  `boolean` |  `false` |  
 |  style |  Allow users to set custom border styles. |  `boolean` |  `false` |  
 |  width |  Allow users to set custom border widths. |  `boolean` |  `false` |  
 |  radiusSizes |  Border radius size presets for the border radius selector. |  `[ { name, slug, size } ]` |   |

---

### 󠀁[color](https://developer.wordpress.org/block-editor/reference-guides/theme-json-reference/theme-json-living/?output_format=md#color)󠁿

Settings related to colors.

  |  Property |  Description |  Type |  Default |  
   |  background |  Allow users to set background colors. |  `boolean` |  `true` |  
 |  custom |  Allow users to select custom colors. |  `boolean` |  `true` |  
 |  customDuotone |  Allow users to create custom duotone filters. |  `boolean` |  `true` |  
 |  customGradient |  Allow users to create custom gradients. |  `boolean` |  `true` |  
 |  defaultDuotone |  Allow users to choose filters from the default duotone filter presets. |  `boolean` |  `true` |  
 |  defaultGradients |  Allow users to choose colors from the default gradients. |  `boolean` |  `true` |  
 |  defaultPalette |  Allow users to choose colors from the default palette. |  `boolean` |  `true` |  
 |  duotone |  Duotone presets for the duotone picker. |  `[ { name, slug, colors } ]` |   |  
 |  gradients |  Gradient presets for the gradient picker. |  `[ { name, slug, gradient } ]` |   |  
 |  link |  Allow users to set link colors in a block. |  `boolean` |  `false` |  
 |  palette |  Color palette presets for the color picker. |  `[ { name, slug, color } ]` |   |  
 |  text |  Allow users to set text colors in a block. |  `boolean` |  `true` |  
 |  heading |  Allow users to set heading colors in a block. |  `boolean` |  `true` |  
 |  button |  Allow users to set button colors in a block. |  `boolean` |  `true` |  
 |  caption |  Allow users to set caption colors in a block. |  `boolean` |  `true` |

---

### 󠀁[dimensions](https://developer.wordpress.org/block-editor/reference-guides/theme-json-reference/theme-json-living/?output_format=md#dimensions)󠁿

Settings related to dimensions.

  |  Property |  Description |  Type |  Default |  
   |  aspectRatio |  Allow users to set an aspect ratio. |  `boolean` |  `false` |  
 |  defaultAspectRatios |  Allow users to choose aspect ratios from the default set of aspect ratios. |  `boolean` |  `true` |  
 |  aspectRatios |  Allow users to define aspect ratios for some blocks. |  `[ { name, slug, ratio } ]` |   |  
 |  height |  Allow users to set custom height. |  `boolean` |  `false` |  
 |  minHeight |  Allow users to set custom minimum height. |  `boolean` |  `false` |  
 |  minWidth |  Allow users to set custom minimum width. |  `boolean` |  `false` |  
 |  width |  Allow users to set custom width. |  `boolean` |  `false` |  
 |  dimensionSizes |  Dimension size presets for dimension block supports. |  `[ { name, slug, size } ]` |   |

---

### 󠀁[layout](https://developer.wordpress.org/block-editor/reference-guides/theme-json-reference/theme-json-living/?output_format=md#layout)󠁿

Settings related to layout.

  |  Property |  Description |  Type |  Default |  
   |  contentSize |  Sets the max-width of the content. |  `string` |   |  
 |  wideSize |  Sets the max-width of wide (`.alignwide`) content. Also used as the maximum viewport when calculating fluid font sizes |  `string` |   |  
 |  allowEditing |  Disable the layout UI controls. |  `boolean` |  `true` |  
 |  allowCustomContentAndWideSize |  Enable or disable the custom content and wide size controls. |  `boolean` |  `true` |

---

### 󠀁[lightbox](https://developer.wordpress.org/block-editor/reference-guides/theme-json-reference/theme-json-living/?output_format=md#lightbox)󠁿

Settings related to the lightbox.

  |  Property |  Description |  Type |  Default |  
   |  enabled |  Defines whether the lightbox is enabled or not. |  `boolean` |   |  
 |  allowEditing |  Defines whether to show the Lightbox UI in the block editor. If set to `false`, the user won’t be able to change the lightbox settings in the block editor. |  `boolean` |   |

---

### 󠀁[position](https://developer.wordpress.org/block-editor/reference-guides/theme-json-reference/theme-json-living/?output_format=md#position)󠁿

Settings related to position.

  |  Property |  Description |  Type |  Default |  
   |  sticky |  Allow users to set sticky position. |  `boolean` |  `false` |

---

### 󠀁[shadow](https://developer.wordpress.org/block-editor/reference-guides/theme-json-reference/theme-json-living/?output_format=md#shadow)󠁿

Settings related to shadows.

  |  Property |  Description |  Type |  Default |  
   |  defaultPresets |  Allow users to choose shadows from the default shadow presets. |  `boolean` |  `true` |  
 |  presets |  Shadow presets for the shadow picker. |  `[ { name, slug, shadow } ]` |   |

---

### 󠀁[spacing](https://developer.wordpress.org/block-editor/reference-guides/theme-json-reference/theme-json-living/?output_format=md#spacing)󠁿

Settings related to spacing.

  |  Property |  Description |  Type |  Default |  
   |  blockGap |  Enables `--wp--style--block-gap` to be generated from styles.spacing.blockGap. |  `boolean`, `null` |  `null` |  
 |  margin |  Allow users to set a custom margin. |  `boolean` |  `false` |  
 |  padding |  Allow users to set a custom padding. |  `boolean` |  `false` |  
 |  units |  List of units the user can use for spacing values. |  `[ string ]` |  `["px","em","rem","vh","vw","%"]` |  
 |  customSpacingSize |  Allow users to set custom space sizes. |  `boolean` |  `true` |  
 |  defaultSpacingSizes |  Allow users to choose space sizes from the default space size presets. |  `boolean` |  `true` |  
 |  spacingSizes |  Space size presets for the space size selector. |  `[ { name, slug, size } ]` |   |  
 |  spacingScale |  Settings to auto-generate space size presets for the space size selector. |  `{ operator, increment, steps, mediumStep, unit }` |   |

---

### 󠀁[typography](https://developer.wordpress.org/block-editor/reference-guides/theme-json-reference/theme-json-living/?output_format=md#typography)󠁿

Settings related to typography.

  |  Property |  Description |  Type |  Default |  
   |  defaultFontSizes |  Allow users to choose font sizes from the default font size presets. |  `boolean` |  `true` |  
 |  customFontSize |  Allow users to set custom font sizes. |  `boolean` |  `true` |  
 |  fontStyle |  Allow users to set custom font styles. |  `boolean` |  `true` |  
 |  fontWeight |  Allow users to set custom font weights. |  `boolean` |  `true` |  
 |  fluid |  Enables fluid typography and allows users to set global fluid typography parameters. |  `boolean`, `{ minFontSize, maxViewportWidth, minViewportWidth }` |  `false` |  
 |  letterSpacing |  Allow users to set custom letter spacing. |  `boolean` |  `true` |  
 |  lineHeight |  Allow users to set custom line height. |  `boolean` |  `false` |  
 |  textIndent |  Allow users to set custom line indent. |  `boolean`, `string` |  `"subsequent"` |  
 |  textAlign |  Allow users to set the text align. |  `boolean` |  `true` |  
 |  textColumns |  Allow users to set the number of text columns. |  `boolean` |  `false` |  
 |  textDecoration |  Allow users to set custom text decorations. |  `boolean` |  `true` |  
 |  textShadow |  Allow users to set custom text shadows. |  `boolean` |  `true` |  
 |  defaultTextShadowPresets |  Allow users to choose text shadows from the default text shadow presets. |  `boolean` |  `true` |  
 |  textShadowPresets |  Text shadow presets for the text shadow picker. |  `[ { name, slug, textShadow } ]` |   |  
 |  writingMode |  Allow users to set the writing mode. |  `boolean` |  `false` |  
 |  textTransform |  Allow users to set custom text transforms. |  `boolean` |  `true` |  
 |  dropCap |  Enable drop cap. |  `boolean` |  `true` |  
 |  fontSizes |  Font size presets for the font size selector. |  `[ { name, slug, size, fluid } ]` |   |  
 |  fontFamilies |  Font family presets for the font family selector. |  `[ { name, slug, fontFamily, fontFace } ]` |   |

---

### 󠀁[viewport](https://developer.wordpress.org/block-editor/reference-guides/theme-json-reference/theme-json-living/?output_format=md#viewport)󠁿

Viewport breakpoint settings used for responsive block styles and block visibility.
Invalid breakpoint values are ignored. If only one valid breakpoint is declared,
it remains keyed by its configured viewport and uses a single max-width query. If
neither breakpoint is valid, the default breakpoints are used. If `mobile` is greater
than or equal to `tablet`, only the `mobile` breakpoint is used.

  |  Property |  Description |  Type |  Default |  
   |  mobile |  Maximum viewport width for mobile styles. |  `string` |  `"480px"` |  
 |  tablet |  Maximum viewport width for tablet styles. Tablet styles apply above the mobile width and up to this width when both breakpoints are configured, or up to this width when tablet is the only valid breakpoint. |  `string` |  `"782px"` |

---

### 󠀁[custom](https://developer.wordpress.org/block-editor/reference-guides/theme-json-reference/theme-json-living/?output_format=md#custom)󠁿

Generate custom CSS custom properties of the form `--wp--custom--{key}--{nested-
key}: {value};`. `camelCased` keys are transformed to `kebab-case` as to follow 
the CSS property naming schema. Keys at different depth levels are separated by `--`,
so keys should not include `--` in the name.

---

## 󠀁[styles](https://developer.wordpress.org/block-editor/reference-guides/theme-json-reference/theme-json-living/?output_format=md#styles)󠁿

Organized way to set CSS properties. Styles in the top-level will be added in the`
body` selector.

In a block style variation partial (a theme.json file with a `blockTypes` property),
the styles are scoped to the listed block types instead, and the responsive (`@mobile`,`@
tablet`) and pseudo-selector (`:hover`, `:focus`, `:focus-visible`, `:active`) states
available to block style variations are also allowed at this level.

### 󠀁[background](https://developer.wordpress.org/block-editor/reference-guides/theme-json-reference/theme-json-living/?output_format=md#background-2)󠁿

Background styles.

  |  Property |  Description |  Type |  
   |  backgroundImage |  Sets the `background-image` CSS property. |  `string`, `{ ref }`, `{ url }` |  
 |  backgroundPosition |  Sets the `background-position` CSS property. |  `string`, `{ ref }` |  
 |  backgroundRepeat |  Sets the `background-repeat` CSS property. |  `string`, `{ ref }` |  
 |  backgroundSize |  Sets the `background-size` CSS property. |  `string`, `{ ref }` |  
 |  backgroundAttachment |  Sets the `background-attachment` CSS property. |  `string`, `{ ref }` |  
 |  backgroundClip |  Sets the `background-clip` CSS property. One of `border-box`, `padding-box`, `content-box` or `text`. |  `string`, `{ ref }` |

---

### 󠀁[border](https://developer.wordpress.org/block-editor/reference-guides/theme-json-reference/theme-json-living/?output_format=md#border-2)󠁿

Border styles.

  |  Property |  Description |  Type |  
   |  color |  Sets the `border-color` CSS property. |  `string`, `{ ref }` |  
 |  radius |  Sets the `border-radius` CSS property. |  `string`, `{ ref }`, `{ topLeft, topRight, bottomLeft, bottomRight }` |  
 |  style |  Sets the `border-style` CSS property. |  `string`, `{ ref }` |  
 |  width |  Sets the `border-width` CSS property. |  `string`, `{ ref }` |  
 |  top |   |  `{ color, style, width }` |  
 |  right |   |  `{ color, style, width }` |  
 |  bottom |   |  `{ color, style, width }` |  
 |  left |   |  `{ color, style, width }` |

---

### 󠀁[color](https://developer.wordpress.org/block-editor/reference-guides/theme-json-reference/theme-json-living/?output_format=md#color-2)󠁿

Color styles.

  |  Property |  Description |  Type |  
   |  background |  Sets the `background-color` CSS property. |  `string`, `{ ref }` |  
 |  gradient |  Sets the `background` CSS property. |  `string`, `{ ref }` |  
 |  text |  Sets the `color` CSS property. |  `string`, `{ ref }` |

---

### 󠀁[css](https://developer.wordpress.org/block-editor/reference-guides/theme-json-reference/theme-json-living/?output_format=md#css)󠁿

Sets custom CSS to apply styling not covered by other theme.json properties.

---

### 󠀁[dimensions](https://developer.wordpress.org/block-editor/reference-guides/theme-json-reference/theme-json-living/?output_format=md#dimensions-2)󠁿

Dimensions styles.

  |  Property |  Description |  Type |  
   |  aspectRatio |  Sets the `aspect-ratio` CSS property. |  `string`, `{ ref }` |  
 |  height |  Sets the `height` CSS property. |  `string`, `{ ref }` |  
 |  minHeight |  Sets the `min-height` CSS property. |  `string`, `{ ref }` |  
 |  minWidth |  Sets the `min-width` CSS property. |  `string`, `{ ref }` |  
 |  width |  Sets the `width` CSS property. |  `string`, `{ ref }` |

---

### 󠀁[filter](https://developer.wordpress.org/block-editor/reference-guides/theme-json-reference/theme-json-living/?output_format=md#filter)󠁿

CSS and SVG filter styles.

  |  Property |  Description |  Type |  
   |  duotone |  Sets the duotone filter. |  `string`, `{ ref }` |

---

### 󠀁[outline](https://developer.wordpress.org/block-editor/reference-guides/theme-json-reference/theme-json-living/?output_format=md#outline)󠁿

Outline styles.

  |  Property |  Description |  Type |  
   |  color |  Sets the `outline-color` CSS property. |  `string`, `{ ref }` |  
 |  offset |  Sets the `outline-offset` CSS property. |  `string`, `{ ref }` |  
 |  style |  Sets the `outline-style` CSS property. |  `string`, `{ ref }` |  
 |  width |  Sets the `outline-width` CSS property. |  `string`, `{ ref }` |

---

### 󠀁[shadow](https://developer.wordpress.org/block-editor/reference-guides/theme-json-reference/theme-json-living/?output_format=md#shadow-2)󠁿

Box shadow styles.

---

### 󠀁[spacing](https://developer.wordpress.org/block-editor/reference-guides/theme-json-reference/theme-json-living/?output_format=md#spacing-2)󠁿

Spacing styles.

  |  Property |  Description |  Type |  
   |  blockGap |  Sets the `--wp--style--block-gap` CSS custom property when settings.spacing.blockGap is true. |  `string`, `{ ref }` |  
 |  margin |  Margin styles. |  `{ top, right, bottom, left }` |  
 |  padding |  Padding styles. |  `{ top, right, bottom, left }` |

---

### 󠀁[typography](https://developer.wordpress.org/block-editor/reference-guides/theme-json-reference/theme-json-living/?output_format=md#typography-2)󠁿

Typography styles.

  |  Property |  Description |  Type |  
   |  fontFamily |  Sets the `font-family` CSS property. |  `string`, `{ ref }` |  
 |  fontSize |  Sets the `font-size` CSS property. |  `string`, `{ ref }` |  
 |  fontStyle |  Sets the `font-style` CSS property. |  `string`, `{ ref }` |  
 |  fontWeight |  Sets the `font-weight` CSS property. |  `string`, `{ ref }` |  
 |  letterSpacing |  Sets the `letter-spacing` CSS property. |  `string`, `{ ref }` |  
 |  lineHeight |  Sets the `line-height` CSS property. |  `string`, `{ ref }` |  
 |  textIndent |  Sets the `text-indent` CSS property. |  `string`, `{ ref }` |  
 |  textAlign |  Sets the `text-align` CSS property. |  `string`, `{ ref }` |  
 |  textColumns |  Sets the `column-count` CSS property. |  `string`, `{ ref }` |  
 |  textDecoration |  Sets the `text-decoration` CSS property. |  `string`, `{ ref }` |  
 |  textShadow |  Sets the `text-shadow` CSS property. |  `string`, `{ ref }` |  
 |  writingMode |  Sets the `writing-mode` CSS property. |  `string`, `{ ref }` |  
 |  textTransform |  Sets the `text-transform` CSS property. |  `string`, `{ ref }` |

---

## 󠀁[customTemplates](https://developer.wordpress.org/block-editor/reference-guides/theme-json-reference/theme-json-living/?output_format=md#customtemplates)󠁿

Additional metadata for custom templates defined in the templates folder.

  |  Property |  Description |  Type |  
   |  name |  Filename, without extension, of the template in the templates folder. |  `string` |  
 |  title |  Title of the template, translatable. |  `string` |  
 |  postTypes |  List of post types that can use this custom template. |  `[ string ]` |

## 󠀁[templateParts](https://developer.wordpress.org/block-editor/reference-guides/theme-json-reference/theme-json-living/?output_format=md#templateparts)󠁿

Additional metadata for template parts defined in the parts folder.

  |  Property |  Description |  Type |  
   |  name |  Filename, without extension, of the template in the parts folder. |  `string` |  
 |  title |  Title of the template, translatable. |  `string` |  
 |  area |  The area the template part is used for. Block variations for `header` and `footer` values exist and will be used when the area is set to one of those. |  `string` |

## 󠀁[patterns](https://developer.wordpress.org/block-editor/reference-guides/theme-json-reference/theme-json-living/?output_format=md#patterns)󠁿

An array of pattern slugs to be registered from the Pattern Directory.

Type: `[ string ]`.

First published

January 14, 2022

Last updated

September 28, 2026

Edit article

[ Improve it on GitHub: Theme.json Version 3 Reference (latest) ](https://github.com/WordPress/gutenberg/edit/trunk/docs/reference-guides/theme-json-reference/theme-json-living.md)

[  Previous: Theme.json Reference](https://developer.wordpress.org/block-editor/reference-guides/theme-json-reference/)

[  Next: Theme.json Version 1 Reference](https://developer.wordpress.org/block-editor/reference-guides/theme-json-reference/theme-json-v1/)