Version 1 Reference Edit

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

Settings Settings

Top ↑

border border

Settings related to borders.

Property Type Default Props
customRadius boolean false

Top ↑

color 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 layout

Settings related to layout.

Property Type Default Props
contentSize string
wideSize string

Top ↑

spacing spacing

Settings related to spacing.

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

Top ↑

typography 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 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 Styles

Top ↑

border border

Border styles.

Property Type Props
radius string

Top ↑

color color

Color styles.

Property Type Props
background string
gradient string
text string

Top ↑

spacing spacing

Spacing styles.

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

Top ↑

typography typography

Typography styles.

Property Type Props
fontSize string
lineHeight string