Theme.json Version 1 Reference Edit

Theme.json version 2 has been released, see the theme.json migration guide for updating to the latest version.

Settings

Top ↑

border

Settings related to borders.

Property Type Default Props
customRadius boolean false

Top ↑

color

Settings related to colors.

Property Type Default Props
custom boolean true
customDuotone boolean true
customGradient boolean true
duotone array colors, name, slug
gradients array gradient, name, slug
link boolean false
palette array color, name, slug

Top ↑

layout

Settings related to layout.

Property Type Default Props
contentSize string
wideSize string

Top ↑

spacing

Settings related to spacing.

Property Type Default Props
customMargin boolean false
customPadding boolean false
units array px,em,rem,vh,vw,%

Top ↑

typography

Settings related to typography.

Property Type Default Props
customFontSize boolean true
customLineHeight boolean false
dropCap boolean true
fontSizes array name, size, slug

Top ↑

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.


Top ↑

Styles

Top ↑

border

Border styles.

Property Type Props
radius string

Top ↑

color

Color styles.

Property Type Props
background string
gradient string
text string

Top ↑

spacing

Spacing styles.

Property Type Props
margin object bottom, left, right, top
padding object bottom, left, right, top

Top ↑

typography

Typography styles.

Property Type Props
fontSize string
lineHeight string