Enterprise Themes

theme.json Design System

A constrained global design system — curated palettes and deliberately disabled controls — that makes the editor produce on-brand pages by default.

theme.jsonDesign TokensEditor GovernanceAccessibility

What it does

theme.json defines the platform’s global styles and, just as deliberately, the boundaries of editor freedom: content and wide measures, root-padding-aware alignment, and a small brand palette exposed only where it belongs — background colors on layout blocks, a short list of heading colors — with arbitrary color, border, spacing, and typography controls switched off.

Why it exists

On a governed platform, unrestricted design controls are how brand and accessibility erode one page at a time. Encoding the design system in theme.json makes the correct choices the default and the incorrect ones simply unavailable, so consistency is enforced by the platform itself rather than caught in review after the fact.

Engineering considerations

Built on theme.json version 3 with appearance tools and most global controls disabled, then re-enabled selectively per block — layout blocks receive the brand background palette, headings a constrained text palette, custom blocks their own controlled options. Layout is fixed to a 60rem content and 100rem wide measure with fluid root padding, so every template and pattern inherits the same spatial rhythm without editors needing to think about it.

Screenshots & media
Scoped color palette in the editor
Scoped color palette in the editor
Per-block curated palettes (theme.json)
Per-block curated palettes (theme.json)
Global styles from tokens (theme.json)
Global styles from tokens (theme.json)
Contact

Start a Conversation

Matt works directly with teams and agencies on enterprise WordPress development, from custom Gutenberg experiences to large-scale builds and ongoing engineering support. Available for remote contract engagements.

Connect with Matt