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
border
Settings related to borders.
Property | Type | Default | Props |
---|---|---|---|
customRadius | boolean | false |
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 |
layout
Settings related to layout.
Property | Type | Default | Props |
---|---|---|---|
contentSize | string | ||
wideSize | string |
spacing
Settings related to spacing.
Property | Type | Default | Props |
---|---|---|---|
customMargin | boolean | false | |
customPadding | boolean | false | |
units | array | px,em,rem,vh,vw,% |
typography
Settings related to typography.
Property | Type | Default | Props |
---|---|---|---|
customFontSize | boolean | true | |
customLineHeight | boolean | false | |
dropCap | boolean | true | |
fontSizes | array | name, size, slug |
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
border
Border styles.
Property | Type | Props |
---|---|---|
radius | string |
color
Color styles.
Property | Type | Props |
---|---|---|
background | string | |
gradient | string | |
text | string |
spacing
Spacing styles.
Property | Type | Props |
---|---|---|
margin | object | bottom, left, right, top |
padding | object | bottom, left, right, top |
typography
Typography styles.
Property | Type | Props |
---|---|---|
fontSize | string | |
lineHeight | string |