Migrating to Newer Versions Edit
This guide documents the changes between different
theme.json versions and how to upgrade. Using older versions will continue to be supported. Upgrading is recommended because new development will continue in the newer versions.
Upgrading to v2 enables some new features and adjusts the naming of some old features to be more consistent with one another.
How to migrate from v1 to v2:
- Rename the properties that were updated (see below) if you’re using them.
New top-level properties:
Additions to settings:
Additions to styles:
The default font sizes provided by core (
settings.typography.fontSizes) have been updated. The Normal and Huge sizes (with
huge slugs) have been removed from the list, and Extra Large (
x-large slug) has been added. When the UI controls show the default values provided by core, Normal and Huge will no longer be present. However, their CSS classes and CSS Custom Properties are still enqueued to make sure existing content that uses them still works as expected.