Cheat Sheet: Every setting that you can remove using theme.json

Last updated

Below is a code example of every setting that you can remove using theme.json:

{
	"version": 2,
	"settings": {
		"appearanceTools": false,
		"background": {
			"backgroundImage": false,
			"backgroundSize": false
		},
		"border": {
			"color": false,
			"radius": false,
			"style": false,
			"width": false
		},
		"color": {
			"text": false,
			"background": false,
			"link": false,
			"heading": false,
			"button": false,
			"caption": false,
			"custom": false,
			"customDuotone": false,
			"customGradient": false,
			"defaultDuotone": false,
			"defaultGradients": false,
			"defaultPalette": false
		},
		"dimensions": {
			"minHeight": false
		},
		"layout": {
			"contentSize": null,
			"wideSize": null,
			"allowEditing": false,
			"allowCustomContentAndWideSize":false
		},
		"position": {
			"sticky": false
		},
		"spacing": {
			"blockGap": null,
			"margin": false,
			"padding": false,
			"units": [],
			"customSpacingSize": false,
			"spacingScale": []
		},
		"shadow": {
			"defaultPresets": false
		},
		"typography": {
			"customFontSize": false,
			"dropCap": false,
			"fontStyle": false,
			"fontWeight": false,
			"fluid": false,
			"letterSpacing": false,
			"lineHeight": false,
			"textDecoration": false,
			"textTransform": false,
			"writingMode": false,
			"fontSizes": [],
			"fontFamilies": []
		},
		"useRootPaddingAwareAlignments": false,
		"blocks": {
			"core/image": {
				"lightbox": {
					"allowEditing": false,
					"enabled": false
				}
			}
		}
	}
}

Note that if you remove the background image support, it does not remove any existing background images from your blocks.

To disable the “Inherit default layout” setting for container blocks like group, remove the

"layout": {
"contentSize": null,
"wideSize": null
},

Known issues

The border settings for the pullquote and button blocks are not disabled if the border settings are disabled globally: #56628 #56626.

Border allows custom color picker even when custom color is set to false in theme.json: #59567

The shadow panel can not be completely disabled: #48753