This reference guide lists the settings and style properties defined in the theme.json schema. See the theme.json how to guide for examples and guide on how to use the theme.json file in your theme.
Theme.json Reference
First published
January 4, 2022
Last updated
July 17, 2026
Edit article
Chapters
Chapter list- Block Editor Handbook
- Getting Started
- How-to Guides
- Accessibility
- Blocks
- Development Platform
- Create your First App with Gutenberg Data
- Curating the Editor Experience
- Enqueueing assets in the Editor
- Feature Flags
- Formatting Toolbar API
- Internationalization
- Meta Boxes
- Notices
- Plugin Sidebar
- Propagating updates for block types
- Themes
- Client-Side Media Processing
- Thunks in Core-Data
- Widgets
- Reference Guides
- Block API Reference
- Core Blocks Reference
- Design Blocks
- Embed Blocks
- Media Blocks
- Reusable Blocks
- Text Blocks
- Theme Blocks
- Avatar
- Breadcrumbs
- Comment Author Avatar (deprecated)
- Comment Author Name
- Comment Content
- Comment Date
- Comment Edit Link
- Comment Reply Link
- Comments Next Page
- Comments Page Numbers
- Comments Previous Page
- Comments Pagination
- Comments Title
- Comments
- Login/out
- Navigation
- Pattern Placeholder
- Author Biography
- Author Name
- Author (deprecated)
- Comment (deprecated)
- Comments Count
- Comments Form
- Comments Link
- Content
- Date
- Excerpt
- Featured Image
- Post Navigation Link
- Post Template
- Post Terms
- Time to Read
- Title
- No Results
- Next Page
- Page Numbers
- Previous Page
- Pagination
- Query Title
- Query Total
- Query Loop
- Read More
- Site Logo
- Site Tagline
- Site Title
- Template Part
- Term Count
- Term Description
- Term Name
- Term Template
- Terms Query
- Widgets Blocks
- Hooks Reference
- Interactivity API Reference
- SlotFills Reference
- RichText Reference
- Theme.json Reference
- View Configuration Reference
- Component Reference
- BaseField
- Flyout
- DimensionControl
- Navigation
- AlignmentMatrixControl
- AnglePickerControl
- Animate
- Autocomplete
- BaseControl
- BorderBoxControl
- BorderControl
- BoxControl
- ButtonGroup
- Button
- CardBody
- DateCalendar
- CardDivider
- DateRangeCalendar
- CardFooter
- CardHeader
- CardMedia
- Card
- CheckboxControl
- CircularOptionPicker
- ClipboardButton
- ColorIndicator
- ColorPalette
- ColorPicker
- ComboboxControl
- Composite
- ConfirmDialog
- ContentEditableControl
- CustomSelectControl
- Dashicon
- DatePicker
- DateTime
- TimePicker
- Disabled
- Divider
- Draggable
- DropZone
- DropdownMenu
- Dropdown
- DuotonePicker
- Elevation
- ExternalLink
- FlexBlock
- FlexItem
- Flex
- FocalPointPicker
- FocusableIframe
- FontSizePicker
- FormFileUpload
- FormToggle
- FormTokenField
- GradientPicker
- Grid
- Guide
- HStack
- Heading
- NavigateRegions
- HigherOrder
- WithConstrainedTabbing
- WithFallbackStyles
- WithFilters
- WithFocusOutside
- WithFocusReturn
- WithNotices
- WithSpokenMessages
- Icon
- InputControl
- IsolatedEventContainer
- ItemGroup
- Item
- KeyboardShortcuts
- MenuGroup
- MenuItem
- MenuItemsChoice
- Modal
- NavigableContainer
- Navigator
- Notice
- NumberControl
- Panel
- Placeholder
- Popover
- ProgressBar
- QueryControls
- RadioControl
- RadioGroup
- RangeControl
- ResizableBox
- ResizeTooltip
- ResponsiveWrapper
- Sandbox
- ScrollLock
- Scrollable
- SearchControl
- SelectControl
- SlotFill
- Snackbar
- Spacer
- Spinner
- Surface
- TabPanel
- TextControl
- TextHighlight
- Text
- TextareaControl
- ToggleControl
- ToggleGroupControlOptionBase
- ToggleGroupControlOptionIcon
- ToggleGroupControlOption
- ToggleGroupControl
- ToolbarButton
- ToolbarDropdownMenu
- ToolbarGroup
- ToolbarItem
- Toolbar
- ToolsPanelHeader
- ToolsPanelItem
- ToolsPanel
- Tooltip
- TreeGrid
- TreeSelect
- Truncate
- UnitControl
- VStack
- VisuallyHidden
- ZStack
- Package Reference
- @wordpress/custom-templated-path-webpack-plugin
- @wordpress/experiments
- @wordpress/library-export-default-webpack-plugin
- @wordpress/a11y
- @wordpress/abilities
- @wordpress/admin-ui
- @wordpress/annotations
- @wordpress/api-fetch
- @wordpress/asset-loader
- @wordpress/autop
- @wordpress/babel-plugin-import-jsx-pragma
- @wordpress/babel-plugin-makepot
- @wordpress/babel-preset-default
- @wordpress/base-styles
- @wordpress/blob
- @wordpress/block-directory
- @wordpress/block-editor
- @wordpress/block-library
- @wordpress/block-serialization-default-parser
- @wordpress/block-serialization-spec-parser
- @wordpress/blocks
- @wordpress/boot
- @wordpress/browserslist-config
- @wordpress/commands
- @wordpress/components
- @wordpress/compose
- @wordpress/core-abilities
- @wordpress/core-commands
- @wordpress/core-data
- @wordpress/create-block-interactive-template
- @wordpress/create-block-tutorial-template
- @wordpress/create-block
- @wordpress/customize-widgets
- @wordpress/data-controls
- @wordpress/data
- @wordpress/dataviews
- @wordpress/date
- @wordpress/dependency-extraction-webpack-plugin
- @wordpress/deprecated
- @wordpress/design-system-mcp
- @wordpress/docgen
- @wordpress/dom-ready
- @wordpress/dom
- @wordpress/e2e-test-utils-playwright
- @wordpress/e2e-tests
- @wordpress/edit-post
- @wordpress/edit-site
- @wordpress/edit-widgets
- @wordpress/editor
- @wordpress/element
- @wordpress/env
- @wordpress/escape-html
- @wordpress/eslint-plugin
- @wordpress/fields
- @wordpress/format-library
- @wordpress/global-styles-engine
- @wordpress/global-styles-ui
- @wordpress/grid
- @wordpress/hooks
- @wordpress/html-entities
- @wordpress/i18n
- @wordpress/icons
- @wordpress/image-cropper
- @wordpress/interactivity-router
- @wordpress/interactivity
- @wordpress/interface
- @wordpress/is-shallow-equal
- @wordpress/jest-console
- @wordpress/jest-preset-default
- @wordpress/kebab-case
- @wordpress/keyboard-shortcuts
- @wordpress/keycodes
- @wordpress/latex-to-mathml
- @wordpress/lazy-editor
- @wordpress/lazy-import
- @wordpress/list-reusable-blocks
- @wordpress/media-editor
- @wordpress/media-fields
- @wordpress/media-utils
- @wordpress/notices
- @wordpress/npm-package-json-lint-config
- @wordpress/nux
- @wordpress/patterns
- @wordpress/plugins
- @wordpress/postcss-plugins-preset
- @wordpress/postcss-themes
- @wordpress/preferences-persistence
- @wordpress/preferences
- @wordpress/prettier-config
- @wordpress/primitives
- @wordpress/priority-queue
- @wordpress/private-apis
- @wordpress/project-management-automation
- @wordpress/react-i18n
- @wordpress/readable-js-assets-webpack-plugin
- @wordpress/redux-routine
- @wordpress/reusable-blocks
- @wordpress/rich-text
- @wordpress/route
- @wordpress/router
- @wordpress/scripts
- @wordpress/server-side-render
- @wordpress/shortcode
- @wordpress/style-engine
- @wordpress/style-runtime
- @wordpress/stylelint-config
- @wordpress/sync
- @wordpress/theme
- @wordpress/token-list
- @wordpress/ui
- @wordpress/undo-manager
- @wordpress/upload-media
- @wordpress/url
- @wordpress/video-conversion
- @wordpress/viewport
- @wordpress/views
- @wordpress/vips
- @wordpress/warning
- @wordpress/widget-dashboard
- @wordpress/widget-primitives
- @wordpress/widgets
- @wordpress/wordcount
- @wordpress/worker-threads
- @wordpress/build
- Data Module Reference
- The NUX (New User Experience) Data
- WordPress Core Data
- Annotations
- Block directory
- The Block Editors Data
- Block Types Data
- The Commands Data
- Customize Widgets
- The Editors UI Data
- Edit Site
- Edit Widgets
- The Post Editors Data
- The Keyboard Shortcuts Data
- Notices Data
- Preferences
- Reusable blocks
- Rich Text
- The Viewport Data
- Explanations
- Contributor Guide
- Code Contributions
- Design Contributions
- Documentation Contributions
- Triage
- Localizing Gutenberg
- Accessibility Testing
- Repository Management
- Folder Structure
- Gutenberg versions in WordPress
The WordPress® trademark is the intellectual property of the WordPress Foundation.
![[Code is Poetry]](https://s.w.org/style/images/code-is-poetry-for-dark-bg.svg){kind=link}