The WordPress coreCoreCore is the set of software required to run WordPress. The Core Development Team builds WordPress. development team builds WordPress! Follow this site for general updates, status reports, and the occasional code debate. There’s lots of ways to contribute:
Found a bugbugA bug is an error or unexpected result. Performance improvements, code optimization, and are considered enhancements, not defects. After feature freeze, only bugs are dealt with, with regressions (adverse changes from the previous version) being the highest priority.?Create a ticket in the bug tracker.
“What’s new in GutenbergGutenbergThe Gutenberg project is the new Editor Interface for WordPress. The editor improves the process and experience of creating new content, making writing rich content much simpler. It uses ‘blocks’ to add richness rather than shortcodes, custom HTML etc.
https://wordpress.org/gutenberg/…” posts (labeled with the #gutenberg-new tag) are posted following every Gutenberg release on a biweekly basis, showcasing new features included in each release. As a reminder, here’s an overview of different ways to keep up with Gutenberg and the Editor.
This release ships the new modal-based media editor as the default cropping experience, advances the experimental customizable WordPress dashboard with five new widgets and significant layout polish, and upgrades the editor to ReactReactReact is a JavaScript library that makes it easy to reason about, construct, and maintain stateless and stateful user interfaces.
https://reactjs.org 19. Responsive styles now extend to individual blockBlockBlock is the abstract term used to describe units of markup that, composed together, form the content or layout of a webpage using the WordPress editor. The idea combines concepts of what in the past may have achieved with shortcodes, custom HTML, and embed discovery into a single consistent API and user experience. instances, and Notes blocks gain support for multiple discussion threads. Other changes include DataViews adopting @wordpress/theme design tokens, accessibilityAccessibilityAccessibility (commonly shortened to a11y) refers to the design of products, devices, services, or environments for people with disabilities. The concept of accessible design ensures both “direct access” (i.e. unassisted) and “indirect access” meaning compatibility with a person’s assistive technology (for example, computer screen readers). (https://en.wikipedia.org/wiki/Accessibility) refinements across the RevisionsRevisionsThe WordPress revisions system stores a record of each saved draft or published update. The revision system allows you to see what changes were made in each revision by dragging a slider (or using the Next/Previous buttons). The display indicates what has changed in each revision. interface, continued Real-time Collaboration reliability fixes, and broader preload coverage for faster post editor loads.
Table of contents
Media editor modal becomes the default crop experience
The Media editor modal replaces the existing inline cropping tool in the Block Editor. The modal pattern keeps the familiar Crop button entry point, and brings freeform and aspect-ratio cropping, flip, fine-grained and snap rotation, and metadata editing into one dedicated workflow. (78653)
Experimental customizable WordPress dashboard
The experimental customizable WordPress dashboard — a widgetWidgetA WordPress Widget is a small block that performs a specific function. You can add these widgets in sidebars also known as widget-ready areas on your web page. WordPress widgets were originally created to provide a simple and easy-to-use way of giving design and structure control of the WordPress theme to the user.-based surface available for testing behind an experimental flag in the Gutenberg pluginPluginA plugin is a piece of software containing a group of functions that can be added to a WordPress website. They can extend functionality or add new features to your WordPress websites. WordPress plugins are written in the PHP programming language and integrate seamlessly with WordPress. These can be free in the WordPress.org Plugin Directory https://wordpress.org/plugins/ or can be cost-based plugin from a third-party., allowing users to add, move, resize, and rearrange widgets. It introduces a complete set of widgets — Welcome, Quick Draft, Activity, Site Health, Site Preview, and more — that automatically adapt to different tile sizes. You can fully customize your dashboard by choosing which widgets to display, arranging the layout, adjusting the number of columns, and resizing each widget’s width and height. (77616)
This change is experimental; to give it a try, first go to WP-Adminadmin(and super admin) > Gutenberg > Experiments and enable “New Dashboard experience”.
Responsive styles for block instance
Responsive styles for block instances (78384) building on 23.2’s responsive Global Styles, the Block Style States APIAPIAn API or Application Programming Interface is a software intermediary that allows programs to interact with each other and share data in limited, clearly defined ways. extends to the per-instance level (76491). Block instance responsive styles include layout styles (78543) and an Inspector that shows only the relevant settings when a style state is selected. (78280) (78658, 78763, 78670, 78709)
Other Notable Highlights
Real-time Collaboration improvements — Notes blocks support multiple threads (75147), better handling of oversized payloads (>16 MiB) and connection-loss states (77724), protocol-mismatch error handling (76991), fewer refresh storms when peers edit (78483), and a mobile fix for Edit/Join row actions in the post list (78597).
DataViews adopts @wordpress/theme design tokens (75204) — the first significant in-codebase adoption of the design tokens package. A new “Introduction” Storybook page has been added for the tokens themselves (78449).
Accessibility wins — Image block gains a “Mark as decorative” toggle (78064); Revisions diff markers get higher-contrast stripes and scale with user text-size preferences (78473, 78273, 78393); Breadcrumbs block hides separators from screen readers (78524).
Performance — Optimized block-supports CSSCSSCascading Style Sheets. class rendering (78217), lazy-fetched user pattern categories (78568), shared window listeners across block instances (78310), shared MediaQueryList listener in useMediaQuery (78297), and broader preload coverage on edit-post load (78508, 78565).
Components migrations — Continued migrationMigrationMoving the code, database and media files for a website site from one server to another. Most typically done when changing hosting companies. of __experimentalText, __experimentalHStack, and __experimentalVStack to their stable @wordpress/ui counterparts (78155); Tooltip migration progressed across block-editor, editor, and DataViews consumers (78411, 78466, 78470).
React 19 upgrade (61521) — Gutenberg is now built against React 19. Most code keeps working unchanged; plugin authors using removed legacy patterns (string refs, ReactDOM.render fallbacks, defaultProps on function components) should review React’s upgrade notes.
Changelog
Features
Post Editor
Notes: Support multiple note threads per block. (75147)
UI Card: Full bleed as headerHeaderThe header of your site is typically the first thing people will experience. The masthead or header art located across the top of your page is part of the look and feel of your website. It can influence a visitor’s opinion about your content and you/ your organization’s brand. It may also look different on different screen sizes. hero image and content cover. (77856)
Visually align Notice from @wordpress/components with Notice from @wordpress/ui. (78231)
Collab SidebarSidebarA sidebar in WordPress is referred to a widget-ready area used by WordPress themes to display information that is not a part of the main content. It is not always a vertical column on the side. It can be a horizontal rectangle below or above the content area, footer, header, or any where in the theme.: Swap near-identical pink for red in avatarAvatarAn avatar is an image or illustration that specifically refers to a character that represents an online user. It’s usually a square box that appears next to the user’s name. palette. (78299)
Media Editor: Make the modal the default crop experience. (78653)
RTC: Provide PROTOCOL_MISMATCH error handling. (76991)
useDialog: Handle Escape via React onKeyDown so cascade works through portals. (78433)
Block Library
Block/Tabs: Fix editor dirty state on reload by removing unnecessary mount-time attribute init. (78339)
Breadcrumbs block: Hide separator from screen readers. (78524)
Fix ‘InvalidinvalidA resolution on the bug tracker (and generally common in software development, sometimes also notabug) that indicates the ticket is not a bug, is a support request, or is generally invalid. Date’ when clicking on Now in DateTimePicker on Date Block. (78284)
Fix Tabs block losing added tabs when the editor is reopened. (78250)
Fix: Discard unsaved HTMLHTMLHyperText Markup Language. The semantic scripting language primarily used for outputting content in web browsers. block changes on cancel. (78580)
Image: Preserve width/height when converting Classic blocks to blocks. (78610)
Navigation Link: Preserve custom labels during link updates. (77186)
Navigation: Restore block_core_navigation_submenu_render_submenu_icon() as deprecated shim. (78484)
Prevent images from appearing squished when only one dimension is set. (70575)
Post Editor
Editor: Disable Visual Revisions when classic metaMetaMeta is a term that refers to the inside workings of a group. For us, this is the team that works on internal WordPress sites like WordCamp Central and Make WordPress. boxes are present. (78249)
Editor: Fix Visual Revisions meta keys overlap. (78156)
Editor: Use _n() for revisions count aria-label. (78382)
Fix: Register user-defined taxonomies after user-defined post types. (78497)
Fix: Show collaborators when the top toolbar is active. (78049)
Global styles revisions: Ensure stylebook shows revision previews. (78490)
Script Loader: Defer single-page admin init until DOMContentLoaded (TracTracAn open source project by Edgewall Software that serves as a bug tracker and project management tool for WordPress.#65103). (78136)
Upload Media: Render srcset on the front end for client-side-media uploads. (78359)
Block Editor
Block Inspector: Hide Styles tab in preview mode. (78230)
Block Toolbar: Prevent position shifts when using mover control. (77798)
Fix inconsistencies in feature selector processing part 2: Pseudo block instances. (78326)
Fix: Properly merge schema during mergeSchemas part in getBlockContentSchemaFromTransforms. (70615)
List View: Place caret at end of block when selecting. (76797)
Unset grid span defaults with viewport states enabled. (78709)
Data Layer
CoreCoreCore is the set of software required to run WordPress. The Core Development Team builds WordPress. Data: Avoid duplicate ID-less entity permission requests. (78262)
Fix: Disable collab sync when incompatible meta boxes are present. (78145)
RTC: Fix cursor awareness / presence bugbugA bug is an error or unexpected result. Performance improvements, code optimization, and are considered enhancements, not defects. After feature freeze, only bugs are dealt with, with regressions (adverse changes from the previous version) being the highest priority. in nested rich text elements. (77673)
RTC: Fix block refresh on every update when a peer edits within the code editor. (78483)
RTC: Sync the content even if it’s a function. (76796)
Real-time Collaboration: Use minimal save payload in persistCRDTDoc. (77050)
Media
Media Editor Modal: Only show the crop active state when using keyboard. (78266)
Media Editor: Anchor cursorless zoom (slider/keyboard) at crop center. (78385)
Media Editor: Enforce a minimum crop size in the image editor. (78268)
Media Editor: Scope keyboard shortcuts to the modal. (78322)
Media Fields: Fix filename truncation with Tooltip. (78453)
Collaboration
RTC: Fix Edit/Join row action invisible on mobile in post list. (78597)
RTC: Fix connection lost error modal when /wp-json/wp-sync/v1/updates exceeds 16 MiB limit. (77724)
Global Styles
Fix block preview for responsive style states. (78538)
Fix inconsistencies in feature selector processing part 1: Global styles. (78276)
Client Side Media
Upload Media: Stop propagating -scaled to sub-size filenames. (78038)
VIPS: Remove dead batchResizeImage and vipsBatchResizeImage exports. (77975)
Paste
Keep <img> inside <a> when pasting plain-text HTML. (78015)
Image Editor: Focus return after closing image crop modal. (78711)
Revisions: Increase diff marker stripe contrast to 75% primary color proportion. (78473)
Revisions: Scale diff markers width with user text-size preference. (78273)
Revisions: Use CSS outline as secondary non-color indicator for diff blocks. (78393)
Block Library
Image block: Add “Mark as decorative” toggle for accessibility. (78064)
Image: Fix missing aria-label on lightbox trigger button for single images. (78426)
Performance
Block supports: Optimize custom CSS class rendering and parsing. (78217)
Fix performance tests when running against old reference commit. (78288)
Post Editor
Edit Post: Hoist setupEditor to run before root.render. (78581)
Edit Post: Consume preload cache before React mount. (78508)
Editor / Block Editor: Lazy-fetch user pattern categories. (78568)
Post Taxonomies: Drop redundant per_page: -1 from taxonomyTaxonomyA taxonomy is a way to group things together. In WordPress, some common taxonomies are category, link, tag, or post format. https://codex.wordpress.org/Taxonomies#Default_Taxonomies. queries. (78569)
Docs: Update iframeiframeiFrame is an acronym for an inline frame. An iFrame is used inside a webpage to load another HTML document and render it. This HTML document may also contain JavaScript and/or CSS which is loaded at the time when iframe tag is parsed by the user’s browser. editor migration guide for WordPress 7.0/7.1. (78401)
Editor: Inline text editor toolbar z-index. (78309)
REST: Guard setAccessible() behind PHPPHPThe web scripting language in which WordPress is primarily architected. WordPress requires PHP 7.4 or higher < 8.1 in block-editor settings controller. (78478)
Use WCIcon alias for component Icon imports. (78366)
Use WCTooltip alias for component Tooltip imports. (78396)
Block Editor
Fix additional issues with block registration types. (78416)
Migrate __experimentalText, __experimentalHStack, and __experimentalVStack to Text and Stack. (78155)
Refactor: useMemo on elements and useCallback is back on resetAllFilter. (78329)
Simplify component ESLint rules and extend to routes/widgets. (78519)
Update the BlockAttribute typedef to allow for multi-type attributes. (78517)
Guidelines
Add data-slug attribute to settings list items. (78676)
Fix flaky tests (publish-panel.spec.js focus assertion before panel close completed). (77893)
Guard PHP unit testunit testCode written to test a small piece of code or functionality within a larger application. Everything from themes to WordPress core have a series of unit tests. Also see regression. to avoid failures on old WP versions. (78547)
Perf tests: Capture loading durations before stopTracing(). (78294)
Perf tests: Disable Playwright tracing to remove snapshot overhead. (78295)
Perf tests: Save Chromium traces as CI artifacts. (77974)
Performance tests: Fix template click, delete pages at startup. (78193)
Post Editor perf test: Remove unwanted actions from timed area. (78323)
Preload: BackportbackportA port is when code from one branch (or trunk) is merged into another branch or trunk. Some changes in WordPress point releases are the result of backporting code from trunk to the release branch. user global styles entry for classic themes on WP 6.9. (78546)
RTC: Add command to run in WebSockets mode. (78363)
Tests: Add timezone-mock to test/unit/package.json. (78277)
The addition of a free-form image cropper in the BlockBlockBlock is the abstract term used to describe units of markup that, composed together, form the content or layout of a webpage using the WordPress editor. The idea combines concepts of what in the past may have achieved with shortcodes, custom HTML, and embed discovery into a single consistent API and user experience. Editor has been a long-standing feature request. A GutenbergGutenbergThe Gutenberg project is the new Editor Interface for WordPress. The editor improves the process and experience of creating new content, making writing rich content much simpler. It uses ‘blocks’ to add richness rather than shortcodes, custom HTML etc.
https://wordpress.org/gutenberg/ experiment that integrates this and other image editing features in a “Media EditorModal” is ready for testing and feedback.
What is it?
The Media Editor Modal replaces the existing inline cropping tool in the Block Editor. The modal pattern keeps the familiar Crop button entry point, and brings freeform and aspect-ratio cropping, flip, fine-grained and snap rotation, and metadata editing into one dedicated workflow.
Under the hood, the modal consumes a coreCoreCore is the set of software required to run WordPress. The Core Development Team builds WordPress. collection custom tools and components that will eventually live in a WordPress package. This will remove the reliance on third-party cropping libraries.
Why the Change?
Image cropping in the Block Editor hasn’t changed much since its introduction. The existing inline image cropper is built on top of the react-easy-crop library. This implementation has a couple of constraints:
it’s limited by what’s achievable in the editor canvas and block toolbar, and
the library itself has a narrow set of features.
Why build our own library? Well-maintained, open sourceOpen SourceOpen Source denotes software for which the original source code is made freely available and may be redistributed and modified. Open Source **must be** delivered via a licensing model, see GPL. alternatives that do most of what users expect are few and far between. Furthermore, there’s a general preference for a WordPress-native surface that:
has all the features we want “out of the box” such as aspect ratios, freeform cropping handles, intuitive zooming, flip and rotation,
includes all the usability features we’d expect such as touch and keyboard support, and
is extensibleExtensibleThis is the ability to add additional functionality to the code. Plugins extend the WordPress core software. in ways idiomatic to the WordPress ecosystem.
There was an attempt to build a custom, editor-first cropper component, but it was abandoned. Rather than developing separate, one-off flows across blocks, the Media Editor Modal aims to provide a consistent foundation for both a new Media Library experience and various editor contexts, and also serve as platform for building more sophisticated experiences later.
How to Test
If you’re familiar with the Gutenberg plugin development environment, you can check out trunktrunkA directory in Subversion containing the latest development code in preparation for the next major release cycle. If you are running "trunk", then you are on the latest revision. right now and enable the Media Modal experiment from the experiments page at /wp-admin/admin.php?page=experiments-wp-admin
Update: #78653 merged, which makes the modal the default experience. No requirement to enable any experiment.
The quickest way to test is via Playground. Here’s a link that loads up Playground with Gutenberg Trunk and the Media Editor Modal active:
The steps are provided just in case you need structure. Don’t feel any need to follow any or all of them.
The important question is whether the modal is solid enough as a replacement for the Image block crop flow, and whether you notice any bugs, UXUXUser experience gaps or unexpected behaviors.
Basic Crop Flow
Open the modal from an Image block.
Resize the crop area.
Pan and zoom the image.
Rotate or flip the image.
Save.
Confirm the block updates to use the edited image.
Details Editing
In a saved post with a title, upload or insert an image.
Open the modal from the Image block.
Switch to the Details tab.
Confirm Author and Attached to fields are populated with your author handle and the current post’s title.
Update alt text and caption.
Save.
Confirm the media item updates.
Confirm the Image block updates when its existing alt/caption values were empty or matched the original media values.
Existing Custom Block Values
Add an Image block.
Manually enter custom alt text or a custom caption in the block.
Open the media editor modal.
Change the attachment’s alt text or caption.
Save.
Confirm custom block-level values are not unexpectedly overwritten.
Keyboard
Open the modal.
Use Tab to move through the crop area, crop handles, toolbar controls, sidebarSidebarA sidebar in WordPress is referred to a widget-ready area used by WordPress themes to display information that is not a part of the main content. It is not always a vertical column on the side. It can be a horizontal rectangle below or above the content area, footer, header, or any where in the theme. controls, Save, Cancel, and Close.
Use arrow keys to move or resize the crop area.
Confirm focus is visible and does not get lost.
Try undo/redo with keyboard shortcuts.
Confirm Escape behaves as expected when there are unsaved changes.
Touch Gestures
On a touch device, open the modal from an Image block.
Test drag panning, pinch zoom, and crop area handle dragging for responsiveness and smoothness.
Ensure toolbar actions like rotate, flip, undo, redo, and reset are tappable.
Sharing your Feedback
Comments on this post are a great way to share feedback, but if you’d like to jump into Gutenberg feel free to leave feedback on this tracking issue as it’s the main one covering current tasks for the experimental modal. We’d love to know for example:
Did the modal open where you expected it to?
Was cropping understandable without extra instruction?
Did anything feel slower, confusing, or broken?
Did the image tools, including Save and Cancel behave as you’d expect?
Out of Scope
The goal is to make the basic crop/edit workflow solid first, not to ship every image editing feature. Some related work is still being explored separately, for example:
Manual pixel crop controls.
Restoring original image.
Improving undo/redo history states.
Broader image editor extensibility for image filterFilterFilters are one of the two types of Hooks https://codex.wordpress.org/Plugin_API/Hooks. They provide a way for functions to modify data of other functions. They are the counterpart to Actions. Unlike Actions, filters are meant to work in an isolated manner, and should never have side effects such as affecting global variables and output. and/or AI integration options.
Thank you for making it this far, and thanks in advance for testing.
“What’s new in GutenbergGutenbergThe Gutenberg project is the new Editor Interface for WordPress. The editor improves the process and experience of creating new content, making writing rich content much simpler. It uses ‘blocks’ to add richness rather than shortcodes, custom HTML etc.
https://wordpress.org/gutenberg/…” posts (labeled with the #gutenberg-new tag) are posted following every Gutenberg release on a biweekly basis, showcasing new features included in each release. As a reminder, here’s an overview of different ways to keep up with Gutenberg and the Editor.
This release introduces responsive global blockBlockBlock is the abstract term used to describe units of markup that, composed together, form the content or layout of a webpage using the WordPress editor. The idea combines concepts of what in the past may have achieved with shortcodes, custom HTML, and embed discovery into a single consistent API and user experience. styles with states, brings further improvements to the experimental Content Types management screens, and adds a wave of accessibilityAccessibilityAccessibility (commonly shortened to a11y) refers to the design of products, devices, services, or environments for people with disabilities. The concept of accessible design ensures both “direct access” (i.e. unassisted) and “indirect access” meaning compatibility with a person’s assistive technology (for example, computer screen readers). (https://en.wikipedia.org/wiki/Accessibility) refinements to the RevisionsRevisionsThe WordPress revisions system stores a record of each saved draft or published update. The revision system allows you to see what changes were made in each revision by dragging a slider (or using the Next/Previous buttons). The display indicates what has changed in each revision. interface. The @wordpress/ui package gains a new SelectControl and motion design tokens, while modals now render as bottom sheets on mobile. Other changes include shortcodeShortcodeA shortcode is a placeholder used within a WordPress post, page, or widget to insert a form or function generated by a plugin in a specific location on your site.-to-block transforms, Grid component enhancements, Connectors refinements, and continued Real-time Collaboration reliability fixes.
You can now customize how individual blocks look on different screen sizes, right from Global Styles.
Head to Global Styles → Blocks, and you’ll find a new States dropdown on each block with Tablet and Mobile options. Select a state, make your style changes, and they’ll apply only to that breakpoint.
This allows theme developers and site builders to define different block styles depending on viewport size and interaction state, paving the way for more adaptive designs managed entirely through the editor. (#77513)
Add motion design tokens (duration and easing) to wordpress/theme
Adds motion design tokens to @wordpress/theme — a set of duration and easing curve tokens for standardizing animation timing across components — and adopts them in Dialog, Modal, and Menu/DropdownMenu.
Modal renders as a bottom sheet on mobile
The Modal component now adapts to narrow viewports by rendering as a bottom sheet, providing a more touch-friendly experience on phones and small tablets. (#77956)
With the new position, important actions are easier to reach with one hand.
Other Notable Highlights
Content Types management improvements (experimental): The experimental Content Types screens are extended with several refinements: taxonomyTaxonomyA taxonomy is a way to group things together. In WordPress, some common taxonomies are category, link, tag, or post format. https://codex.wordpress.org/Taxonomies#Default_Taxonomies. visibility fields let you control where taxonomies appear (#77835), slugs are now auto-filled from the singular label (#77938), and new term/post type count fields provide an at-a-glance view of content usage (#78157). Additional quality-of-life actions—duplicate, view, and quick-edit—round out the management experience.
SelectControl added to @wordpress/ui. A new SelectControl primitive joins the design-system package, offering a consistent select input across the editor and adminadmin(and super admin) surfaces. (#77809)
Shortcode-to-block transforms. The Embed block now recognizes [ embed ] shortcodes (#77937), and the Shortcode block offers block-specific transforms when the text matches a registered shortcode (#77944).
Grid component improvements. The @wordpress/grid package gains a renderResizeHandle render prop (#77811), an edit-mode overlay for DashboardGrid and DashboardLanes (#78199), document cursor lock during resize (#77813), and resize-runaway prevention near the viewport edge (#77854).
Revisions accessibility improvements. Diff markers now enforce a 24×24 px minimum target size per WCAGWCAGWCAG is an acronym for Web Content Accessibility Guidelines. These guidelines are helping make sure the internet is accessible to all people no matter how they would need to access the internet (screen-reader, keyboard only, etc) https://www.w3.org/TR/WCAG21/. 2.5.8 (#77671), use diagonal stripe patterns to avoid color-only distinction (#77904), and display tooltips (#77690). The revisions slider now paginates by 100 per page for better performance (#77200).
Real-time Collaboration reliability fixes. Title divergence between users on page refresh has been resolved (#77666), a race condition on room creation that could split the update log is fixed (#77675), and find_canonical_storage_post_id() no longer returns null incorrectly (#78053).
Connectors refinements.PluginPluginA plugin is a piece of software containing a group of functions that can be added to a WordPress website. They can extend functionality or add new features to your WordPress websites. WordPress plugins are written in the PHP programming language and integrate seamlessly with WordPress. These can be free in the WordPress.org Plugin Directory https://wordpress.org/plugins/ or can be cost-based plugin from a third-party. registration now supports an is_active callback (#77897), settings are only auto-registered when the referenced plugin is actually installed and active (#77273), and the Connectors page works on read-only file systems (#77521).
Changelog
Features
Block Editor
Try responsive global block styles with states. (77513)
Enhance the Connectors page on the read-only file system. (77521)
Enhancements
Components
Add SelectControl component to wordpress/ui. (77809)
Add motion design tokens (duration and easing) to wordpress/theme. (76097)
Button: Align link variant underline with Link and ExternalLink. (77842)
docgen: Automatic documentation handle for TypeScript overloads. (77558)
ui/Tooltip, ui/IconButton: Add positioner slot APIAPIAn API or Application Programming Interface is a software intermediary that allows programs to interact with each other and share data in limited, clearly defined ways.. (78089)
Shortcode: Offer block-specific transforms when text matches a registered shortcode. (77944)
i18ni18nInternationalization, or the act of writing and preparing code to be fully translatable into other languages. Also see localization. Often written with a lowercase i so it is not confused with a lowercase L or the numeral 1. Often an acquired skill.: Add context to table headerHeaderThe header of your site is typically the first thing people will experience. The masthead or header art located across the top of your page is part of the look and feel of your website. It can influence a visitor’s opinion about your content and you/ your organization’s brand. It may also look different on different screen sizes./footer label. (78007)
Block Editor
Fix the target block for copying direct insert block attributes. (77877)
Make Block Inserter search input sticky while scrolling. (77698)
WidgetWidgetA WordPress Widget is a small block that performs a specific function. You can add these widgets in sidebars also known as widget-ready areas on your web page. WordPress widgets were originally created to provide a simple and easy-to-use way of giving design and structure control of the WordPress theme to the user. Types: Bootstrap registry into the dashboard client. (77917)
Widget Types: Replace bootstrap with resolver. (77847)
npm Packages
Build: Add widgets/ folder support to wordpress/build. (77347)
Taxonomy edit route: Declare @wordpress/base-styles as dependency. (77901)
Bug Fixes
Components
ColorPalette: Fix duplicate-key warnings and incorrect selection with identical color values. (78004)
Fix: Only auto-register settings if the plugin the connector references is installed and active. (77273)
Increase the right padding of the callout for the mobile layout. (78126)
Block Library
Embed: Tighten raw URLURLA specific web address of a website or web page on the Internet, such as a website’s URL www.wordpress.org transform isMatch. (78021)
Fix: The buttons block shows the inserter picker when multiple allowed blocks are registered. (77858)
Fix: Shortcode block does not render in Navigation Overlay. (77511)
Post Editor
Editor: Paginate revisions slider by 100 per page. (77200)
Notes: Keep tall floating threads scrollable on short content. (77821)
defaultRenderingMode value not respected when changed using block_editor_settings_all. (77870)
Site Editor: Preserve non-global editor styles in pattern previews. (77957)
Preserve the leading number when pasting single-line text like dates. (77949)
Add aria-label to the Revisions button in the Post Summary sidebarSidebarA sidebar in WordPress is referred to a widget-ready area used by WordPress themes to display information that is not a part of the main content. It is not always a vertical column on the side. It can be a horizontal rectangle below or above the content area, footer, header, or any where in the theme.. (78140)
Widget Types: REST endpoint and coreCoreCore is the set of software required to run WordPress. The Core Development Team builds WordPress.-data entity. (77987)
Image editor: Suppress image editor undo/redo while a crop interaction is active. (77930)
Image editor: Update sidebar aspect ratio and resize controls. (78046)
Media Editor Modal: Improve image cropper interactions (undo/redo, pan, zoom, rotation), expand keyboard shortcuts and accessibility (focus borders, landmark regions, panel headings), and fix empty metadata fields. (77782, 77826, 77863, 77871, 77875, 77878, 77898, 77899, 78078, 78189). This is an MVPMinimum Viable Product"A minimum viable product (MVP) is a product with just enough features to satisfy early customers, and to provide feedback for future product development." - WikiPedia version, and it’s ready for testing here: https://make.wordpress.org/core/2026/05/21/media-editor-modal-call-for-testing/
Media editor: Replace fine-rotation slider with RotationRuler. (77906)
Grid: Add a warning about being under development. (78022)
Backend default layout filterFilterFilters are one of the two types of Hooks https://codex.wordpress.org/Plugin_API/Hooks. They provide a way for functions to modify data of other functions. They are the counterpart to Actions. Unlike Actions, filters are meant to work in an isolated manner, and should never have side effects such as affecting global variables and output.. (78040)
Add Classic block migrationMigrationMoving the code, database and media files for a website site from one server to another. Most typically done when changing hosting companies. notice. (78090)
Image block: Try syncing updated metadata fields (alt and caption) from the media editor. (78139)
Media Editor Experiment: Add a route, based on the media editor modal, and refactor the modal components. (77994)
Documentation
Block Editor: Clarify logic for ‘directInsert’ inner blocks setting. (77873)
Design System: Add missing packages to Storybook introduction. (77504)
Docs: Shortcode transforms with wrapped content + rawHandler JSDoc. (78003)
Document how to ignore VSCode Workspace Settings. (77608)
RTC: Clarify WPBlockSelection type and link to duplicates in other packages. (77862)
Revise README for FocalPointPicker component to use object-position. (77722)
UI: Add component status notes to Storybook. (77988)
UI: Add missing Portal subcomponents to Storybook. (78108)
UI: Improve documentation for compound exports. (78212)
Update nvm installation script to version 0.40.4. (77996)
Update references to the default branchbranchA directory in Subversion. WordPress uses branches to store the latest development code for each major release (3.9, 4.0, etc.). Branches are then updated with code for any minor releases of that branch. Sometimes, a major version of WordPress and its minor versions are collectively referred to as a "branch", such as "the 4.0 branch".. (77606)
Code Quality
Add a 1-day minimum release age to npm installs. (78191)
Script Modules: Guard setAccessible() calls behind the PHPPHPThe web scripting language in which WordPress is primarily architected. WordPress requires PHP 7.4 or higher < 8.1 check. (78137)
Inline z-index values across Block Manager, metaMetaMeta is a term that refers to the inside workings of a group. For us, this is the team that works on internal WordPress sites like WordCamp Central and Make WordPress. boxes, pattern chooser, sticky search, layout, and Popover, and remove local z-index helper entries. (77753, 77759, 77772, 77806, 77807, 77808, 78180, 78181)
Post Editor
Editor: Refactor ‘PostPublishPanel’ into a function component. (78083)
Edit Post: Fix suppressed errors in the Layout component. (77940)
Notes: Separate intent from mechanics in openTheSidebar. (78039)
Fix the flaky Menu space key unit testunit testCode written to test a small piece of code or functionality within a larger application. Everything from themes to WordPress core have a series of unit tests. Also see regression.. (77972)
Fonts: Move admin menu compat from experimental to WordPress-7.0. (78227)
Block Editor
Add translationtranslationThe process (or result) of changing text, words, and display formatting to support another language. Also see localization, internationalization. context for “Exit pattern”. (78158)
BackportbackportA port is when code from one branch (or trunk) is merged into another branch or trunk. Some changes in WordPress point releases are the result of backporting code from trunk to the release branch. changes in core. (78103)
Refactor client-side style states to use nodes. (78000)
Refactor accordion to use CollapsibleCard. (77903)
Classic Block: Use onReplace prop for migration actions. (78113)
Data Layer
ESLint: Replace eslint-plugin-react-compiler with eslint-plugin-react-hooks. (69962)
RTC: Add regressionregressionA software bug that breaks or degrades something that previously worked. Regressions are often treated as critical bugs or blockers. Recent regressions may be given higher priorities. A "3.6 regression" would be a bug in 3.6 that worked as intended in 3.5. tests for the data corruption bugbugA bug is an error or unexpected result. Performance improvements, code optimization, and are considered enhancements, not defects. After feature freeze, only bugs are dealt with, with regressions (adverse changes from the previous version) being the highest priority. due to the cursor scope issue. (77662)
What’s new in GutenbergGutenbergThe Gutenberg project is the new Editor Interface for WordPress. The editor improves the process and experience of creating new content, making writing rich content much simpler. It uses ‘blocks’ to add richness rather than shortcodes, custom HTML etc.
https://wordpress.org/gutenberg/ 23.1? (07 May)
“What’s new in Gutenberg…” posts (labeled with the #gutenberg-new tag) are posted following every Gutenberg release on a biweekly basis, showcasing new features included in each release. As a reminder, here’s an overview of different ways to keep up with Gutenberg and the Editor.
This release introduces two new experiments aimed at managing content inside the editor. A Custom Taxonomies management screen lets you create and edit taxonomies from Settings, and a new Media Editor brings better image manipulation into the WordPress media flow. Outside of the editor, the @wordpress/ui package gains new compound primitives, Drawer and Autocomplete, alongside overlay polish. Other changes include an experiment to hide the classic blockBlockBlock is the abstract term used to describe units of markup that, composed together, form the content or layout of a webpage using the WordPress editor. The idea combines concepts of what in the past may have achieved with shortcodes, custom HTML, and embed discovery into a single consistent API and user experience. from the inserter, parallel thumbnail uploads, an early developer preview of @wordpress/grid, and a batch of real-time collaboration reliability fixes.
Faster image upload finalization
Sideload requests for an image’s generated thumbnail sizes used to run sequentially within a single upload. They now run in parallel up to the existing concurrency limit, which speeds up upload completion. (#75888)
The speed improvement is most noticeable on bulk uploads via the Gallery block, large images, and slower connections.
@wordpress/ui primitives
The @wordpress/ui package gains two new primitives and polish across overlay components.
Two new compound primitives ship in 23.1:
Drawer, for slide-in side panels and bottom sheets. (#76690)
Autocomplete, a low-level form primitive for combobox-style inputs. (#77642)
Other polish across overlay components:
The Dialog component gains a new Description subcomponent, plus several tweaks to its spacing and typography to align it better with Drawer. Additionally, its Backdrop only dims the page when the Dialog is modal. (#77194)
Dialog, AlertDialog, and Drawer now support sticky headers and footers when their content scrolls vertically. (#77559)
All overlays *.Popup subcomponents gain a new portal prop which, combined with new optional *.Portal subcomponents, allows for better customization of the portaling behavior. (#77452)
Other Notable Highlights
Custom Taxonomies management (Experiment). An experimental UIUIUser interface for managing custom taxonomies inside WordPress adminadmin(and super admin). With the “Content types: manage custom taxonomies” experiment enabled, a new Taxonomies screen lets you create, edit, activate or deactivate, and delete taxonomies without writing PHPPHPThe web scripting language in which WordPress is primarily architected. WordPress requires PHP 7.4 or higher. Enable it via Gutenberg → Experiments → “Content types: manage custom taxonomies”, then visit Settings → Taxonomies. (#77497, #77524, #77657, #77697)
Image Editor with Freeform Cropper (Experiment). A new experimental Image Editor modal for image manipulation in the Block Editor. The modal enables freeform cropping and other manipulation tools for Image and Site Logo blocks. To test it out, enable the experiment via Gutenberg → Experiments → Media Editor Modal, then, in the editor, click on the Crop icon in the block toolbar. (#77479, #77537, #77540, #77585, #77641)
Disable Classic Block from the inserter. The “Disable TinyMCE” experiment was refocused and landed to disable the Classic block from the inserter. The reason for the change is that removing TinyMCE everywhere broke too many existing flows. Existing Classic block instances continue to work normally, since the change only affects the inserter. A new wp_classic_block_supports_inserterfilterFilterFilters are one of the two types of Hooks https://codex.wordpress.org/Plugin_API/Hooks. They provide a way for functions to modify data of other functions. They are the counterpart to Actions. Unlike Actions, filters are meant to work in an isolated manner, and should never have side effects such as affecting global variables and output. was introduced to allow controlling this behavior. (#77747, #77838, #77840, #77845, #77911)
@wordpress/grid package (developer preview). A new @wordpress/grid package introduces DashboardGrid, a two-dimensional grid component with drag-to-reorder and resize handles for dashboard-style surfaces. The package is in active development, and the APIAPIAn API or Application Programming Interface is a software intermediary that allows programs to interact with each other and share data in limited, clearly defined ways. is expected to evolve in upcoming releases. (#77562)
Real-time Collaboration reliability improvements. Several fixes improve RTC reliability and load behavior. The “Connection Lost” dialog no longer appears when a page registers more sync rooms than the server’s per-request cap. A client/server size-check mismatch that could reject large Yjs updates has been corrected. When two offline users reconnect and both push compactions, they no longer end up in a divergent state. Sync observers also attach after the persisted CRDT document is hydrated, which avoids redundant block re-parsing during editor load. (#77631, #77669, #77980, #77966)
Experimental Image Cropper: Tweak the keyboard interactions with drag handles and canvas. (77639)
Admin UI: Change default heading level from h2 to h1. (77617)
CoreCoreCore is the set of software required to run WordPress. The Core Development Team builds WordPress. Data: Remove redundant memoization wrapper from ‘getQueriedItems’. (77483)
I18Ni18nInternationalization, or the act of writing and preparing code to be fully translatable into other languages. Also see localization. Often written with a lowercase i so it is not confused with a lowercase L or the numeral 1. Often an acquired skill.: Polyfill script module translations for WordPress < 7.0. (77214)
Enhancements
Storybook: Add global preview styles for @wordpress/ui overlays. (77451)
Widgets: Add widgetWidgetA WordPress Widget is a small block that performs a specific function. You can add these widgets in sidebars also known as widget-ready areas on your web page. WordPress widgets were originally created to provide a simple and easy-to-use way of giving design and structure control of the WordPress theme to the user.-types data layer. (77752)
Components
Admin UI: Add visual prop to Page headerHeaderThe header of your site is typically the first thing people will experience. The masthead or header art located across the top of your page is part of the look and feel of your website. It can influence a visitor’s opinion about your content and you/ your organization’s brand. It may also look different on different screen sizes. component. (76469)
Admin UI: Ensure consistent header spacing with and without actions. (76683)
Admin UI: Use UI Text component in header. (77372)
DataForm: Render field description as help text in the array control. (77554)
ExternalLink: Align appearance with Link from @wordpress/ui. (77790)
Tabs: Rename tabs blocks to follow WCAGWCAGWCAG is an acronym for Web Content Accessibility Guidelines. These guidelines are helping make sure the internet is accessible to all people no matter how they would need to access the internet (screen-reader, keyboard only, etc) https://www.w3.org/TR/WCAG21/. Tabs pattern. (77418)
Block Editor
Embed: Restore paragraph with URLURLA specific web address of a website or web page on the Internet, such as a website’s URL www.wordpress.org when undoing paste-to-embed transform. (77551)
Split singleton REST APIREST APIThe REST API is an acronym for the RESTful Application Program Interface (API) that uses HTTP requests to GET, PUT, POST and DELETE data. It is how the front end of an application (think “phone app” or “website”) can communicate with the data store (think “database” or “file system”)
https://developer.wordpress.org/rest-api/ into dedicated /content-guidelines route. (77734)
Bug Fixes
Core Abilities: Export initialization promise as ready. (77254)
Disable Custom CSSCSSCascading Style Sheets. command for non-block themes. (77685)
Grid: Fix width: 'fill' when tiles span multiple rows. (77769)
Tests: Connectors point to the right page. (77272)
PluginPluginA plugin is a piece of software containing a group of functions that can be added to a WordPress website. They can extend functionality or add new features to your WordPress websites. WordPress plugins are written in the PHP programming language and integrate seamlessly with WordPress. These can be free in the WordPress.org Plugin Directory https://wordpress.org/plugins/ or can be cost-based plugin from a third-party.: Gutenberg Experiments: Ensure the experiment is active before outputting flags. (77728)
Connectors: Treat networknetwork(versus site, blog)-active plugins as active. (77661)
Command Palette: Fix macOs label for sites unable to determine UA via PHP. (77638)
Design Tools: viewport visibility — use ‘key’ instead of ‘value’ for device type. (77410)
Layout: Ensure layout classnames are applied to the inner blocks wrapper and not to its siblings. (77408)
Global Styles: Fix pseudo selector block style rendering in the editor. (76879)
Data Layer: Media — move image output format filtering to upload response. (75793)
Media Upload Modal: Fix pagination and search. (77872)
Accordion: Add missing dimension controls and limited customization. (77780)
Featured ImageFeatured imageA featured image is the main image used on your blog archive page and is pulled when the post or page is shared on social media. The image can be used to display in widget areas on your site or in a summary list of posts.: Change toggle label to ‘Make image a link’. (71931)
Image: Preserve aspectRatio and scale when switching to wide/full alignment. (76914)
Form blocks: Update block categories for form, form-input, form-submission-notification, and form-submit-button. (61916)
Image: Fix non-local image ID removal undo trap. (77367)
Tabs: Add classic theme styles to reset button defaults. (77607)
Tabs: Lock top-level structure and disable visibility controls. (77370)
Video Block: Update z-index for tracks popover to ensure proper stacking context. (77517)
Components
CollapsibleCard: Prevent focus ring clipping by content overflow. (77667)
Add cursor pointer to the ariakit menu item component. (70412)
Link: Remove underline from unstyled icon links. (77420)
Storybook: Fix ‘Open sourceOpen SourceOpen Source denotes software for which the original source code is made freely available and may be redistributed and modified. Open Source **must be** delivered via a licensing model, see GPL. file’ links for storybook-local stories. (76758)
Storybook: Fix component descriptions in manifest files. (77112)
Text: Apply both heading and paragraph CSS defenses unconditionally. (77461)
UI: Fix focus-trap broken by ThemeProvider’s display: contents. (77381)
UI: Update @base-ui/react from 1.4.0 to 1.4.1. (77520)
Block Editor
Fix blockGap fallback handling for nested var() fallback values. (77750)
Template parts: Make ‘Detach’ context menu item consistent across patterns and template parts. (77581)
Client Side Media
Deduplicate client-side image sizes with matching dimensions. (77036)
Declare convert_format as boolean arg on sideload route. (77565)
Upload Media: Use .jpg extension for HEIC-to-JPEG client conversion. (77506)
Collaboration
RTC: Fix “Connection Lost” dialog when too many entities are loaded. (77631)
RTC: Fix connection-lost error on large updates caused by mismatch between update size bounds check and expanded base64 update size. (77669)
RTC: Fix divergence when two offline users reconnect. (77980)
AccessibilityAccessibilityAccessibility (commonly shortened to a11y) refers to the design of products, devices, services, or environments for people with disabilities. The concept of accessible design ensures both “direct access” (i.e. unassisted) and “indirect access” meaning compatibility with a person’s assistive technology (for example, computer screen readers). (https://en.wikipedia.org/wiki/Accessibility)
RevisionsRevisionsThe WordPress revisions system stores a record of each saved draft or published update. The revision system allows you to see what changes were made in each revision by dragging a slider (or using the Next/Previous buttons). The display indicates what has changed in each revision.: Improve screen reader accessibility for diff markers region and slider. (77660)
Fix accessibility issues in admin Font Library. (77482)
Connectors
Add role="list" wrapper to connector cards for valid ARIA structure. (77689)
Keep focus on action Button during install. (77544)
Components
CollapsibleCard: Fix missing keyboard focus ring on the header chevron icon when rendered inside wp-admin. (77468)
Tabs: Fix missing keyboard focus ring on the panel in Windows High Contrast mode when rendered inside wp-admin. (77469)
Performance
Post Editor
Notes: Extract floating notes state into a dedicated store. (77424)
Notes: Reduce passes in useBlockComments memo and rename outputs. (77440)
RTC: Attach sync observers after hydrating persisted CRDT doc. (77966)
Dashboard: Register admin page route + sidebarSidebarA sidebar in WordPress is referred to a widget-ready area used by WordPress themes to display information that is not a part of the main content. It is not always a vertical column on the side. It can be a horizontal rectangle below or above the content area, footer, header, or any where in the theme. menu (shell). (77573)
Fix console errors/warnings for taxonomies. (77601)
Follow up improvements on taxonomies (#77497). (77567)
Media editor: Avoid double-mount flicker on open. (77732)
Media editor: Confirm before discarding unsaved changes. (77730)
Update labels for media experiments to better clarify what they do. (77536)
Media Upload Modal: Add MIME type filtering to support text/vtt tracks. (77550)
Experimental Image Cropper: Ensure focus is on canvas when dragging. (77591)
Block Library
Disable TinyMCE: Warn instead of redirecting directly. (77747)
Site Logo Block: Enable the media editor modal experiment for the crop button. (77548)
Classic Block: Unwrap experiment to hide it from inserter. (77911)
Disable Classic block: Always register, hide from inserter conditionally. (77840)
Disable TinyMCE: Repurpose experiment as Classic block removal. (77838)
Post Editor
Image Editor experiment: Pass theme aspect ratios to media editor. (77665)
Media Editor Modal: Add a media editor modal experiment. (77480)
Documentation
Base styles: Update changelog to be clearer. (77767)
Docs: Add ESLint v10 migrationMigrationMoving the code, database and media files for a website site from one server to another. Most typically done when changing hosting companies. guide and polish documentation. (77217)
Docs: Update parameter type from number to int. (77519)
UI/Docs: Clarify package setup for custom WP Admin pages. (77338)
Tooltip: Fix flaky unit testunit testCode written to test a small piece of code or functionality within a larger application. Everything from themes to WordPress core have a series of unit tests. Also see regression.. (77751)
ui: Align WithCustomZIndex Storybook examples across overlays. (77648)
Block Library
Accordion: Remove invalidinvalidA resolution on the bug tracker (and generally common in software development, sometimes also notabug) that indicates the ticket is not a bug, is a support request, or is generally invalid.isBlock prop from ToggleControl. (77776)
Paragraph: Refactor replacement logic in useOnEnter hook. (77383)
Stylelint: Add cursor-pointer rule and block-library override. (77501)
Notes: Refactor and extract offset calculation logic. (77414)
TypeScript: Share ReactReactReact is a JavaScript library that makes it easy to reason about, construct, and maintain stateless and stateful user interfaces.
https://reactjs.org CSS custom properties typing. (77394)
TypeScript: Migrate keyboard-shortcuts to TS. (76287)
Admin UI: Move to CSS modules and implement logical properties. (77088)
Block Editor
Fix import order in block-editor custom-css.js. (77566)
Remove stale reusable block z-index styles. (77774)
Site Editor
Edit Site: Move show-icon-labels handling to specific edit-site call sites. (77287)
Use node_modules/.bin/stylelint to avoid npm warnings on Node 24. (77512)
Jest setup: Remove unneeded rAF and URL polyfills. (77378)
Revert tsgo update (#77177) that broke trunktrunkA directory in Subversion containing the latest development code in preparation for the next major release cycle. If you are running "trunk", then you are on the latest revision.. (77680)
e2e: Shorten visit-site-editor canvas-loader visible wait. (77725) Connectors: Stop end-to-end capabilitycapabilityA capability is permission to perform one or more types of task. Checking if a user has a capability is performed by the current_user_can function. Each user of a WordPress site might have some permissions but not others, depending on their role. For example, users who have the Author role usually have permission to edit their own posts (the “edit_posts” capability), but not permission to edit other users’ posts (the “edit_others_posts” capability). restriction from leaking across specs. (77857)
Fix PHP multisitemultisiteUsed to describe a WordPress installation with a network of multiple blogs, grouped by sites. This installation type has shared users tables, and creates separate database tables for each blog (wp_posts becomes wp_0_posts). See also network, blog, site tests. (77825)
“What’s new in GutenbergGutenbergThe Gutenberg project is the new Editor Interface for WordPress. The editor improves the process and experience of creating new content, making writing rich content much simpler. It uses ‘blocks’ to add richness rather than shortcodes, custom HTML etc.
https://wordpress.org/gutenberg/…” posts (labeled with the #gutenberg-new tag) are posted following every Gutenberg release on a biweekly basis, showcasing new features included in each release. As a reminder, here’s an overview of different ways to keep up with Gutenberg and the Editor.
This release introduces background gradients that work alongside background images in the Group blockBlockBlock is the abstract term used to describe units of markup that, composed together, form the content or layout of a webpage using the WordPress editor. The idea combines concepts of what in the past may have achieved with shortcodes, custom HTML, and embed discovery into a single consistent API and user experience., and adds organized sections to the command palette for better action discovery (experimental). The wordpress/ui package gains a foundational component for consistent empty states, while real-time collaboration receives stability improvements for multi-user editing sessions.
A total of 131 PRs were merged in Gutenberg 22.9, with 5 first-time contributors!
Table of contents
Background gradients alongside background images
The Group block now supports background gradients through a new background.gradient block support, allowing gradients and background images to work together without conflicts. You’ll find a gradient picker in the Background panel that works independently of the existing color gradient controls, making it possible to create gradient overlays on images or combine multiple background effects.
The new background.gradient block support is available to block authors. This also lays the groundwork for eventually migrating color.gradient to background.gradient across all blocks, providing a more consistent and capable background styling system, including clipping and text gradients. (75859)
Command palette history and suggestions (experimental)
The command palette (Cmd+K/Ctrl+K) now features organized sections that make it easier to find and reuse actions. Instead of showing just a search field and search results, users see sections for Recent commands and Suggestions based on current context. This change is experimental; to give it a try, first go to WP-Adminadmin(and super admin) > Gutenberg > Experiments and enable “Workflow Palette”.
Other Notable Highlights
The wordpress/ui package adds a new EmptyState component for displaying placeholder content when sections have no data. This compound component provides flexible composition with sub-components for icons, titles, descriptions, and actions, laying groundwork for consistent empty state patterns across the interface (74719).
Real-time collaboration has received some fixes that improve the multi-user editing experience and stability. Block comments (notes) now properly sync between collaborative editors instead of requiring page refreshes to appear. In the post list, the action button correctly updates from “Join” back to “Edit” when collaboration locks expire. Behind the scenes, error recovery has been enhanced to prevent cascading failures that could previously cause memory issues during collaborative sessions. (76873, 76795, 76872, 76716)
The experimental Forms block now supports hidden input fields, filling an important gap for many applications. Hidden fields appear as selectable placeholder blocks in the editor, while remaining invisible on the frontend with values configurable through the Advanced panel. (74131)
Changelog
Enhancements
Block Editor
DOM: Prefer standard caretPositionFromPoint over deprecated caretRangeFromPoint. (76921)
UI: Update @base-ui/reactReactReact is a JavaScript library that makes it easy to reason about, construct, and maintain stateless and stateful user interfaces.
https://reactjs.org from 1.2.0 to 1.3.0. (76603)
Data Layer
CoreCoreCore is the set of software required to run WordPress. The Core Development Team builds WordPress. Data: Remove offset param from stableKey, use pagination logic. (76808)
Block Library
Block Supports: Add background gradient support that can combine with background images. (75859)
Forms Block: Add hidden input field variation. (74131)
Image/Site Logo: Hide crop toolbar when editMediaEntity is unavailable. (76626)
Login/out block: Add button block class names to the submit button. (76746)
Improvements to dataviews infinite scroll. (74378)
Site Editor
Site Editor > Pages: Move view configuration to the server. (76573)
Site Editor > Patterns & Parts: Generate sidebarSidebarA sidebar in WordPress is referred to a widget-ready area used by WordPress themes to display information that is not a part of the main content. It is not always a vertical column on the side. It can be a horizontal rectangle below or above the content area, footer, header, or any where in the theme. from view configuration. (76823)
Site Editor > Patterns: Move configuration to the server. (76734)
Site Editor > Quick Edit: Add form configuration to endpoint. (76953)
Site Editor > Templates: Move configuration to the server. (76622)
Post Editor
DataForm: Add compact configuration option to the datetime control. (76905)
Navigation Menus
Site Editor v2: Add missing menu items to navigation leaf more menu. (76804)
Connectors
Improve AI pluginPluginA plugin is a piece of software containing a group of functions that can be added to a WordPress website. They can extend functionality or add new features to your WordPress websites. WordPress plugins are written in the PHP programming language and integrate seamlessly with WordPress. These can be free in the WordPress.org Plugin Directory https://wordpress.org/plugins/ or can be cost-based plugin from a third-party. button. (76759)
Collaboration
Add backportbackportA port is when code from one branch (or trunk) is merged into another branch or trunk. Some changes in WordPress point releases are the result of backporting code from trunk to the release branch. for WP_ALLOW_COLLABORATION. (76716)
List Item: Disable edit as HTMLHTMLHyperText Markup Language. The semantic scripting language primarily used for outputting content in web browsers. support. (76897)
Navigation: Avoid List View changing position when navigation block saves. (76659)
Reduce specificity of nav link default padding so global styles apply. (76876)
Show fallback label in MediaControl when filename is empty. (76888)
Site Tagline: Fix block error when migrating deprecated textAlign attribute. (76821)
Connectors
Boot: Fix black area below content when sidebar is taller than page content. (76764)
Align client registration APIAPIAn API or Application Programming Interface is a software intermediary that allows programs to interact with each other and share data in limited, clearly defined ways. with server. (76737)
Support non-AI provider types and add JSJSJavaScript, a web scripting language typically executed in the browser. Often used for advanced user interfaces and behaviors. extensibility end-to-end test. (76722)
Block Editor
Block visibility badge: Use canvas iframeiframeiFrame is an acronym for an inline frame. An iFrame is used inside a webpage to load another HTML document and render it. This HTML document may also contain JavaScript and/or CSS which is loaded at the time when iframe tag is parsed by the user’s browser. for viewport detection. (76889)
Cross Origin Isolation: Remove img from the list of elements that get mutated. (76618)
Fix locked content when switching to a different template without exiting ‘Edit pattern’. (76710)
Hide Additional CSSCSSCascading Style Sheets. controls when block is inside contentOnly editing mode. (76512)
Stop keeping stale controlled blocks after reset. (76591)
Components
Admin UI: Fix Page HeaderHeaderThe header of your site is typically the first thing people will experience. The masthead or header art located across the top of your page is part of the look and feel of your website. It can influence a visitor’s opinion about your content and you/ your organization’s brand. It may also look different on different screen sizes. not rendering with only actions and add stories. (76695)
Button: Restore specificity of high-contrast mode focus ring. (76719)
Card: Add overflow: Clip to root container. (76678)
Fix Color Picker Angle Reset on Gradient Type Change. (76595)
Storybook: Disable autodocs for Icon library. (76620)
compose/useDialog: Add stopPropagation() to Escape handler. (76861)
ui/CollapsibleCard: Do not animate focus ring. (76682)
RevisionsRevisionsThe WordPress revisions system stores a record of each saved draft or published update. The revision system allows you to see what changes were made in each revision by dragging a slider (or using the Next/Previous buttons). The display indicates what has changed in each revision.: Add MetaMetaMeta is a term that refers to the inside workings of a group. For us, this is the team that works on internal WordPress sites like WordCamp Central and Make WordPress. fields diff panel to document sidebar. (76341)
Revisions: Fix template revisions retrieval and sorting. (76760)
Style Book: Fix missing styles for classic themes in stylebook route. (76843)
Collaboration
RTC: Fix notes not syncing between collaborative editors. (76873)
RTC: Fix stuck “Join” link in post list when lock expires. (76795)
RTC: Restore on failed request with compaction update. (76872)
Client Side Media
Build: Remove unused JXL WASM module from vips worker. (76639)
Gate client-side media processing as plugin-only. (76700)
MetaboxMetaboxA post metabox is a draggable box shown on the post editing screen. Its purpose is to allow the user to select or enter information in addition to the main post content. This information should be related to the post in some way.: Fix checkbox style in sidebar. (76718)
Data Layer
Properly resolve getTemplateId for hybrid themes. (76532)
Site Editor
Fix unsupported theme flash on direct URLURLA specific web address of a website or web page on the Internet, such as a website’s URL www.wordpress.org navigation. (76465)
AccessibilityAccessibilityAccessibility (commonly shortened to a11y) refers to the design of products, devices, services, or environments for people with disabilities. The concept of accessible design ensures both “direct access” (i.e. unassisted) and “indirect access” meaning compatibility with a person’s assistive technology (for example, computer screen readers). (https://en.wikipedia.org/wiki/Accessibility)
Components
ComboboxControl: Fix accessible association of help text. (76761)
RadioControl: Add role=”radiogroup” to fieldset. (76745)
ToggleGroupControl: Fix accessible association of help text. (76740)
ControlWithError: Connect validation messages to controls via aria-describedby. (76742)
Fields: Add excerptExcerptAn excerpt is the description of the blog post or page that will by default show on the blog archive page, in search results (SERPs), and on social media. With an SEO plugin, the excerpt may also be in that plugin’s metabox. field. (76829)
React vendor script: Avoid warning on createRoot. (76825)
Set milestone on PRs after cherry-picking to release branchbranchA directory in Subversion. WordPress uses branches to store the latest development code for each major release (3.9, 4.0, etc.). Branches are then updated with code for any minor releases of that branch. Sometimes, a major version of WordPress and its minor versions are collectively referred to as a "branch", such as "the 4.0 branch".. (76652)
Two years ago, efforts were made to provide more clarity in the Gutenberg GitHub repository to make it simpler to keep up to date with work underway at various levels. This post focuses on a piece of that effort: iteration issues and the growing role they can play to make it simpler to follow ongoing work in the GutenbergGutenbergThe Gutenberg project is the new Editor Interface for WordPress. The editor improves the process and experience of creating new content, making writing rich content much simpler. It uses ‘blocks’ to add richness rather than shortcodes, custom HTML etc.
https://wordpress.org/gutenberg/ repository at critical periods. Iteration issues should happen alongside dev notesdev noteEach important change in WordPress Core is documented in a developers note, (usually called dev note). Good dev notes generally include a description of the change, the decision that led to this change, and a description of how developers are supposed to work with that change. Dev notes are published on Make/Core blog during the beta phase of WordPress release cycle. Publishing dev notes is particularly important when plugin/theme authors and WordPress developers need to be aware of those changes.In general, all dev notes are compiled into a Field Guide at the beginning of the release candidate phase. and merge proposals.
Changes to Iteration issues
As a reminder, these iteration issues are solely for following dedicated tracks of work in the Gutenberg repository, and their goal isn’t to replace the TracTracAn open source project by Edgewall Software that serves as a bug tracker and project management tool for WordPress. tickets that we use for tracking tasks.
For each release, open a new iteration issue with the [Type] Iteration label and a name similar to “Feature Name for WordPress X.X”. Do not re-use an iteration issue from a prior release.
Before the betaBetaA pre-release of software that is given out to a large group of users to trial under real conditions. Beta versions have gone through alpha testing in-house and are generally fairly close in look, feel and function to the final product; however, design changes often occur as part of the process. cycle for the release, updates need to happen at a minimum of once per month.
1 week ahead of beta and during beta/RCrelease candidateOne of the final stages in the version release cycle, this version signals the potential to be a final release to the public. Also see alpha (beta). periods, updates need to happen weekly. In particular, emphasis should be put on updates ahead of beta 1, RC1, and the final release.
When the work on a release is done, close the iteration issue and open a new one for the next release as needed.
The aim in doing this is to make it easy for folks to stay up to date on features being worked on for major WordPress releases. Currently, pulling together accurate and up-to-date information remains too fragmented, partially due to either the lack of timely updates to Iteration issues or due to the lack of an iteration issue, leading to too few people who have the time/effort/expertise to sort through it all. This has led to confusion in the lead-up to key moments in the release cycle and is a vulnerability in the process that needs to be rectified. By contributors dedicating themselves more deeply to curating Iteration issues and keeping them up to date, that information can remain a shared resource for all in a consistent way and help us lean towards automation over the reliance of individuals to collate.
When should an iteration issue be opened?
Most, if not all, headline items in roadmap posts need iteration issues. When in doubt, create one.
What makes a good iteration issue?
To help more folks succeed in creating a good iteration issue, there is a new Iteration issue template when creating an issue that follows these best practices:
Assigned contributors planning to work on it. As needed, this includes assigning someone to handle updates.
A scope of work tailored to the release and the timeline, with necessary issues opened.
Any necessary design input or clear requests for design collaboration.
Any open questions or known decisions should be clearly stated, with discussions branching out into various individual issues.
Regular updates in the form of comments on the issue. Specifically, monthly in early stages of the release and weekly at later stages aka starting 1 week before beta 1.
The iteration issue does not need to start this way, but it needs to grow in this direction rapidly as the release process continues. In many cases, an initial iteration issue is opened with a smaller set of known key items to work on, and broader contributors help shape it as the release gets underway.
What makes a good update?
A good update is timely and clearly states completed work, upcoming planned work, any known blockers or decisions to be made, and a broader sense of how the work is progressing. For example, an update that simply lists a changelog of items doesn’t provide a sense of whether work is continuing at the right pace for the release and what is likely to make it or likely not to.
Ahead of key moments in a release, beta 1 and RC 1 in particular, updates need to happen weekly as noted above and should include clear summaries of what is landing in each. These can be used as foundations for any future dev notes, merge proposals, release announcement material, or even documentation.
Let’s keep iterating
Just like these issues, this is an iteration too. Please share feedback, whether you’re handling these iteration issues or using them to stay closer to the work.
“What’s new in GutenbergGutenbergThe Gutenberg project is the new Editor Interface for WordPress. The editor improves the process and experience of creating new content, making writing rich content much simpler. It uses ‘blocks’ to add richness rather than shortcodes, custom HTML etc.
https://wordpress.org/gutenberg/…” posts (labeled with the #gutenberg-new tag) are posted following every Gutenberg release on a biweekly basis, showcasing new features included in each release. As a reminder, here’s an overview of different ways to keep up with Gutenberg and the Editor.
Real-time collaboration now shows collaborator text selections, not just cursor positions. When another user selects text, you see their selection highlighted in their assigned colour — matching the behaviour you’d expect from collaborative editors like Google Docs.
The presence UIUIUser interface has also been polished: avatars are redesigned, you can now see your own presence indicator, and a new Writing preference lets you control whether you receive collaborator notifications. Under the hood, peer limits and disconnection debouncing improve stability for busier editing sessions. (76107, 75652, 76413, 76460, 76565, 76114)
Button pseudo-state styling in Global Styles
A new “State” dropdown now appears next to the Button blockBlockBlock is the abstract term used to describe units of markup that, composed together, form the content or layout of a webpage using the WordPress editor. The idea combines concepts of what in the past may have achieved with shortcodes, custom HTML, and embed discovery into a single consistent API and user experience. title in Global Styles. Selecting a state — Hover, Focus, or Active — switches all the style controls below to edit that specific state. The block preview updates live to show the selected state, giving you a visual preview of how the button will appear on the frontend.
While theme.jsonJSONJSON, or JavaScript Object Notation, is a minimal, readable format for structuring data. It is used primarily to transmit data between a server and web application, as an alternative to XML. has supported pseudo selectors for some time, there has been no visual interface to edit them until now. The Button block is the starting point, with the architecture designed to expand to other blocks in future releases. Separately, theme.json now also supports styling the current/active navigation menuNavigation MenuA theme feature introduced with Version 3.0. WordPress includes an easy to use mechanism for giving various control options to get users to click from one place to another on a site. item and its interactive states, giving theme authors control over active-page highlighting without custom CSSCSSCascading Style Sheets.. (75627, 75736, 76326)
Site Logo & Icon in the Design panel
Site logo and icon management now has its own dedicated screen in the Design panel. The new screen uses a compact media editor for both fields, making it quicker to set or swap your site’s logo and favicon without navigating through adminadmin(and super admin) settings or finding the block settings. (76116)
Connectors extensibility
The Connectors screen, introduced in 22.7, now has a registry APIAPIAn API or Application Programming Interface is a software intermediary that allows programs to interact with each other and share data in limited, clearly defined ways. that allows plugins to register their own connectors. Plugins can use registerConnector() to add entries to the Connectors admin page, and unregisterConnector() to remove them.
These extension points allow any pluginPluginA plugin is a piece of software containing a group of functions that can be added to a WordPress website. They can extend functionality or add new features to your WordPress websites. WordPress plugins are written in the PHP programming language and integrate seamlessly with WordPress. These can be free in the WordPress.org Plugin Directory https://wordpress.org/plugins/ or can be cost-based plugin from a third-party. to integrate with the Connectors system, so it can grow beyond the built-in providers. (76364, 76541, 76142).
Other Notable Highlights
Add navigation links from sidebarSidebarA sidebar in WordPress is referred to a widget-ready area used by WordPress themes to display information that is not a part of the main content. It is not always a vertical column on the side. It can be a horizontal rectangle below or above the content area, footer, header, or any where in the theme. List View: You can now add new links directly from the Site Editor’s sidebar List View for navigation menus, rather than needing to open the block inspector. (75918)
Client-side media processing: Client-side image uploads now support the AVIF format, cross-origin isolation no longer breaks third-party plugin iframes, and server-side plugins that process uploaded images (for watermarking, CDN sync, etc.) now work correctly alongside client-side processing. (76371, 75991, 74913, 76616)
Command Palette in the admin bar: A trigger button for the Command Palette now appears in the WordPress admin bar, making it accessible from anywhere in the admin. The button displays the keyboard shortcut for your platform (⌘K on Mac, Ctrl+K on Windows/Linux). (75757)
Changelog
Features
Collaboration
RTC: Add preference for collaborator notifications. (76460)
Add primitive Text component to wordpress/ui. (75870)
Add styles for outside days in Calendar components. (76199)
Admin UI: Add Storybook stories for Breadcrumbs and Page components. (76467)
Adopt surface-width design tokens for Dialog, Notice, and Modal widths. (76494)
Collapsible.Card: Make contents hidden until found. (76498)
CollapsibleCard: Move trigger to the whole headerHeaderThe header of your site is typically the first thing people will experience. The masthead or header art located across the top of your page is part of the look and feel of your website. It can influence a visitor’s opinion about your content and you/ your organization’s brand. It may also look different on different screen sizes.. (76265)
Editor: Polish real-time collaboration presence UI and move AvatarAvatarAn avatar is an image or illustration that specifically refers to a character that represents an online user. It’s usually a square box that appears next to the user’s name. to editor package. (75652)
ui/Card: Increase padding, align with legacy Card. (76368)
Admin UI: Update font size for title and breadcrumbs to match. (76452)
Connectors
Add AI Experiments plugin callout with install/activate functionality. (76379)
Add connectors registry for extensibility. (76364)
Add empty state when no connectors are registered. (76375)
Add unregisterConnector and upsert support. (76541)
Move plugin status computation to script module data. (76409)
Sync PHPPHPThe web scripting language in which WordPress is primarily architected. WordPress requires PHP 7.4 or higher code with WordPress CoreCoreCore is the set of software required to run WordPress. The Core Development Team builds WordPress.. (76443)
Update page identifier to options-connectors. (76142)
WP Admin: Update Connectors screen footer text for consistency. (76382)
Block Library
Block Library: Improve the design of MediaControlPreview and MediaControl. (76430)
Link Picker: Use Homepage badge instead of Page if Homepage. (75929)
Navigation link: Add support to style current menu item via theme.json. (75736)
Navigation: Allow creating new links in site editor sidebar List View. (75918)
Post Date: Migrate to textAlign block support. (75856)
Post ExcerptExcerptAn excerpt is the description of the blog post or page that will by default show on the blog archive page, in search results (SERPs), and on social media. With an SEO plugin, the excerpt may also be in that plugin’s metabox.: Migrate to textAlign block support. (75860)
Tabs: Disable anchor support on Tab Menu Item. (76442)
Tabs: Restructure Tabs Menu and inner blocks. (75954)
Media: Add hooksHooksIn WordPress theme and development, hooks are functions that can be applied to an action or a Filter in WordPress. Actions are functions performed when a certain event occurs in WordPress. Filters allow you to modify certain functions. Arguments used to hook both filters and actions look the same. and extension points for client-side media processing. (74913)
Collaboration
RTC: Add collaborator selection highlighting in rich text. (76107)
RTC: Allow filtering of SyncConnectionModal. (76554)
RTC: Auto-register custom taxonomyTaxonomyA taxonomy is a way to group things together. In WordPress, some common taxonomies are category, link, tag, or post format. https://codex.wordpress.org/Taxonomies#Default_Taxonomies. rest_base values for CRDT sync. (75983)
RTC: Remove post list lock icon and replace user-specific lock text. (76322)
Use V2 Yjs methods for HTTPHTTPHTTP is an acronym for Hyper Text Transfer Protocol. HTTP is the underlying protocol used by the World Wide Web and this protocol defines how messages are formatted and transmitted, and what actions Web servers and browsers should take in response to various commands. Polling. (76304)
Media Upload Modal: Try an uploading state with popover in the footer. (76228)
Set placeholder to featured imageFeatured imageA featured image is the main image used on your blog archive page and is pulled when the post or page is shared on social media. The image can be used to display in widget areas on your site or in a summary list of posts. field. (76342)
Add confirmation dialog before disconnecting/detaching. (75713)
Interactivity API
Add client-side navigation block with interactive features. (76331)
Command Palette
Add command palette trigger button to admin bar. (75757)
Bug Fixes
Post Editor
Add isNavigationPostEditorKey symbol to fix menu display context. (76461)
Allow Post Content to be edited when ‘Show template’ is active and Post content is nested in a Template Part. (76305)
Client-side media processing: Try plumbing invalidation to the block-editor’s mediaUpload onSuccess callback. (76173)
Editor: Fix autosaves for draft and auto-draft posts. (76624)
Fix: QuickEdit: Consolidate how “Status > Scheduled” works. (76129)
Navigation: Disable Mobile Menu in Isolated Editor or Site Editor Preview. (76203)
Notes: Disable for in-editor revisionsRevisionsThe WordPress revisions system stores a record of each saved draft or published update. The revision system allows you to see what changes were made in each revision by dragging a slider (or using the Next/Previous buttons). The display indicates what has changed in each revision.. (76180)
Page Parent: Change the default value of ‘fieldValue’ state. (76354)
Page/Post Content Focus Mode: Fix insertion into Post Content block. (76477)
RTC: Place sync connection modal in front of popover. (76431)
Revisions: Show changed block attributes in inspector sidebar. (76550)
Revisions: Use useSubRegistry={false} to fix global store selectors. (76152)
Site Editor: Ensure editor settings are populated with server-side settings ASAP. (75785)
Block Library
Cover Block: Add a playlist parameter to loopLoopThe Loop is PHP code used by WordPress to display posts. Using The Loop, WordPress processes each post to be displayed on the current page, and formats it according to how it matches specified criteria within The Loop tags. Any HTML or PHP code in the Loop will be processed on each post. https://codex.wordpress.org/The_Loop YouTube background videos. (76004)
Disables anchor support for the Page Break block. (76434)
Fix: Update the playlist-track file permissions from 755 to 644. (76315)
Fix: Use add_filter() for get_block_type_variations hook. (76297)
HTMLHTMLHyperText Markup Language. The semantic scripting language primarily used for outputting content in web browsers. & ShortcodeShortcodeA shortcode is a placeholder used within a WordPress post, page, or widget to insert a form or function generated by a plugin in a specific location on your site.: Disable viewport visibility support. (76138)
API Fetch: Respect caller-provided Content-Type in httpV1 middleware. (76285)
Connectors
Add logo URLURLA specific web address of a website or web page on the Internet, such as a website’s URL www.wordpress.org support for custom AI providers. (76190)
Align Gutenberg init hook priorities with Core. (76161)
Fetch specific plugin instead of all plugins. (76594)
Gate unavailable install actions behind install capabilitycapabilityA capability is permission to perform one or more types of task. Checking if a user has a capability is performed by the current_user_can function. Each user of a WordPress site might have some permissions but not others, depending on their role. For example, users who have the Author role usually have permission to edit their own posts (the “edit_posts” capability), but not permission to edit other users’ posts (the “edit_others_posts” capability).. (75980)
Improve placeholder text and make it translatable. (75996)
Improve responsive layout for small viewport and screens. (76231, 76186)
Move API key validation and masking to REST dispatch level. (76327)
Show API key source for env vars and wp-config constants. (76266)
Fix RTL styling on AI plugin callout banner. (76497)
Fix RTL styling on Connectors, Font Library, and boot-based admin pages. (76496)
Components
Compose: Implement useCopyToClipboard and useCopyOnClick with native clipboard API. (75723)
Fix token fallback plugins breaking JSJSJavaScript, a web scripting language typically executed in the browser. Often used for advanced user interfaces and behaviors. strings with quoted font names. (76254)
TimePicker: Clamp month day to valid day for month. (76400)
useMediaQuery: Support in-iframeiframeiFrame is an acronym for an inline frame. An iFrame is used inside a webpage to load another HTML document and render it. This HTML document may also contain JavaScript and/or CSS which is loaded at the time when iframe tag is parsed by the user’s browser. queries via new WindowContext. (76446)
Block Editor
Block Bindings: Remove source items constrained by enums. (76200)
Fix HEIC upload error handling and sub-size format. (76514)
Navigation Editor: Allow any blocks to be inserted by gating contentOnly insertion rules to section blocks. (76189)
Rename and visibility modals: Gate shortcuts behind canEditBlock to prevent triggering in revisions UI. (76168)
Fix shortcode conversion when separated by tags. (76213)
DataViews
Add spinner in DataViewsLayout in initial load of data. (76486)
DataForm datetime control: Fix date handling. (76193)
Fields: Hide scheduledDateField from the list and filters. (76247)
Fix last column classname in table layout. (76133)
Fix layout scrolling in constrained-height containers. (76453)
Collaboration
Fix list sidebar reset during real-time collaboration. (76025)
Fix backportbackportA port is when code from one branch (or trunk) is merged into another branch or trunk. Some changes in WordPress point releases are the result of backporting code from trunk to the release branch. changelog PR for Gutenberg #75746. (76154)
Use apiFetch capabilitiescapabilityA capability is permission to perform one or more types of task. Checking if a user has a capability is performed by the current_user_can function. Each user of a WordPress site might have some permissions but not others, depending on their role. For example, users who have the Author role usually have permission to edit their own posts (the “edit_posts” capability), but not permission to edit other users’ posts (the “edit_others_posts” capability)., allow nonce refresh. (76283)
Fix CRDT serialization of nested RichText attributes. (76597)
Fix TypeError in areEditorStatesEqual when selection is undefined. (76163)
Fix cursor index sync with rich text formatting. (76418)
Fix error when entity record doesn’t have ‘metaMetaMeta is a term that refers to the inside workings of a group. For us, this is the team that works on internal WordPress sites like WordCamp Central and Make WordPress.’ property. (76311)
Fix performance regressionregressionA software bug that breaks or degrades something that previously worked. Regressions are often treated as critical bugs or blockers. Recent regressions may be given higher priorities. A "3.6 regression" would be a bug in 3.6 that worked as intended in 3.5. on post save. (76370)
Interactivity API
Fix router initialization race condition on Safari/Firefox. (76053)
Fix crypto.randomUUID crash in non-secure contexts. (76151)
Make Window.scheduler required to match DOM lib. (76271)
Site Editor
Fix block style variations not rendering in Site Editor Patterns page. (76122)
Site Editor > Templates: Fix author filterFilterFilters are one of the two types of Hooks https://codex.wordpress.org/Plugin_API/Hooks. They provide a way for functions to modify data of other functions. They are the counterpart to Actions. Unlike Actions, filters are meant to work in an isolated manner, and should never have side effects such as affecting global variables and output.. (76625)
Client Side Media
Media: Enable AVIF support for client-side uploads. (76371)
Upload Media: Loosen client-side media processing requirements. (76616)
Global Styles
Theme_JSON: Prevent implicit coercion in to_ruleset. (76392)
Fix block pseudo-state styles incorrectly applied to default state. (76326)
Patterns
Block context menu: Context menu not closing for disconnecting unsynced pattern menu items. (75405)
AccessibilityAccessibilityAccessibility (commonly shortened to a11y) refers to the design of products, devices, services, or environments for people with disabilities. The concept of accessible design ensures both “direct access” (i.e. unassisted) and “indirect access” meaning compatibility with a person’s assistive technology (for example, computer screen readers). (https://en.wikipedia.org/wiki/Accessibility)
Revisions: Skip rendered fields in REST APIREST APIThe REST API is an acronym for the RESTful Application Program Interface (API) that uses HTTP requests to GET, PUT, POST and DELETE data. It is how the front end of an application (think “phone app” or “website”) can communicate with the data store (think “database” or “file system”)
https://developer.wordpress.org/rest-api/ responses. (76347)
Design Tools
Block Visibility: Add fetchpriority=auto to IMG tags in blocks with conditional viewport visibility to prevent potential erroneous high loading priority. (76302)
Experiments
Post Editor
Add experiment: Render the editor inspector with DataForm. (76244)
Fields: Add post content information field. (76309)
Fields: Add support for classic themes in template. (76441)
Template field: Match exactly the behavior of post template panel. (76596)
Site Editor
ExtensibleExtensibleThis is the ability to add additional functionality to the code. Plugins extend the WordPress core software. Site Editor: Make canvas previews full height. (76201)
Move site editor preview CSS to boot package. (76211)
Sync some post list changes with Extensible Site Editor. (76243)
Documentation
Add Client-Side Navigation documentation to manifest and table of contents. (76351)
Data: Update documentation for global ‘dispatch’ and ‘select’ methods. (76134)
Docs: Document controlled/uncontrolled prop naming conventions for @wordpress/ui. (76281)
Add [Package] UI label to PR labeler configuration. (76411)
Add support for linting annotations and other static analysis workflow improvements. (76120)
CI: Don’t build release notes during plugin build workflow for WP Core sync. (76398)
CI: Simplify strategy matrix in Build Gutenberg Plugin Zip workflow. (76435)
Check for IS_WORDPRESS_CORE before npm_package_config_IS_WORDPRESS_CORE. (76334)
ESLint: Add bare token check to no-unknown-ds-tokens. (76210)
Fix IS_GUTENBERG_PLUGIN env var override in build configuration. (76605)
Only run label enforcement workflow on open PRs. (76274)
Publish built Gutenberg plugin to the GitHubGitHubGitHub is a website that offers online implementation of git repositories that can easily be shared, copied and modified by other developers. Public repositories are free to host, private repositories require a paid subscription. GitHub introduced the concept of the ‘pull request’ where code changes done in branches by contributors can be reviewed and discussed before being merged by the repository owner. https://github.com/ Container Registry. (75844)
Remove function_exists checks from PHP template. (76062)
Upgrade actionlint and run linting when composite actions are modified. (76503)
Scripts: Relax wordpress/env peer dependency to allow newer versions. (76192)
Ensure consistent, repeatable build results when inlining WASM files via wasmInlinePlugin. (76113)
“What’s new in GutenbergGutenbergThe Gutenberg project is the new Editor Interface for WordPress. The editor improves the process and experience of creating new content, making writing rich content much simpler. It uses ‘blocks’ to add richness rather than shortcodes, custom HTML etc.
https://wordpress.org/gutenberg/…” posts (labeled with the #gutenberg-new tag) are posted following every Gutenberg release on a biweekly basis, showcasing new features included in each release. As a reminder, here’s an overview of different ways to keep up with Gutenberg and the Editor.
This release brings visual change tracking to in-editor revisionsRevisionsThe WordPress revisions system stores a record of each saved draft or published update. The revision system allows you to see what changes were made in each revision by dragging a slider (or using the Next/Previous buttons). The display indicates what has changed in each revision. and introduces a brand-new Icon blockBlockBlock is the abstract term used to describe units of markup that, composed together, form the content or layout of a webpage using the WordPress editor. The idea combines concepts of what in the past may have achieved with shortcodes, custom HTML, and embed discovery into a single consistent API and user experience.. The navigation overlay and client-side media processing both graduate from experimental status. Real-time collaboration adds cursor awareness and can now be enabled through a global settings toggle, and the Gallery block now supports lightbox navigation between images.
A total of 388 PRs were merged in Gutenberg 22.6, with 8 first-time contributors!
Table of contents
In-Editor Revisions: Visual Change Tracking
Browsing post revisions in the editor now shows a color-coded visual diff between the selected revision and its predecessor. Added text appears in green with an underline, removed text in red with a strikethrough, and formatting or attribute changes are highlighted with a yellow outline. Entire blocks, added or removed, are outlined in green or red, respectively. Visual change tracking can be toggled off to view clean content. Colors blend with currentColor so they look appropriate across all themes. (75049)
Icon Block
A brand-new Icon block lets you insert SVG icons from a curated library directly into your content. The block is powered by a new server-side SVG Icon Registration APIAPIAn API or Application Programming Interface is a software intermediary that allows programs to interact with each other and share data in limited, clearly defined ways., so updates to the icon registry propagate to all uses without block validation errors. A REST endpoint at /wp/v2/icons supports searching and filtering. The initial set draws from the wordpress/icons package, and the architecture is designed for future extensibility including third-party icon registration. (71227, 72215, 75576)
Navigation Overlay
Navigation blocks now have customizable overlays and give user full control over mobile hamburger menus. A prominent “Create overlay” button guides you through the setup, providing a selection of patterns to achieve a variety of designs for your overlay. The Navigation Overlay feature is no longer experimental, and is available to all users of the pluginPluginA plugin is a piece of software containing a group of functions that can be added to a WordPress website. They can extend functionality or add new features to your WordPress websites. WordPress plugins are written in the PHP programming language and integrate seamlessly with WordPress. These can be free in the WordPress.org Plugin Directory https://wordpress.org/plugins/ or can be cost-based plugin from a third-party.. (74968, 74971, 75564, 75276)
Client-Side Media Processing
Client-side media processing is a feature that leverages the browser’s capabilitiescapabilityA capability is permission to perform one or more types of task. Checking if a user has a capability is performed by the current_user_can function. Each user of a WordPress site might have some permissions but not others, depending on their role. For example, users who have the Author role usually have permission to edit their own posts (the “edit_posts” capability), but not permission to edit other users’ posts (the “edit_others_posts” capability). to process images. This enables the use of more advanced image formats (including AVIF, WebP, and MozJPEG output encoding) and compression techniques (resulting in ~10–15% smaller file sizes with no quality loss for generated JPEG sub-sizes). It also reduces demand on the web server, thus providing smoother media workflows. As of Gutenberg 22.6, client-side media processing has graduated from experimental state to stable feature. (75081, 74910)
Real-Time Collaboration
Real-time collaboration sees a major round of development in this release. A new toggle under Settings > Writing lets you enable the feature, and once active, collaborators editing the same post see each other’s cursor positions and block selections in real time. A presence indicator in the editor headerHeaderThe header of your site is typically the first thing people will experience. The masthead or header art located across the top of your page is part of the look and feel of your website. It can influence a visitor’s opinion about your content and you/ your organization’s brand. It may also look different on different screen sizes. shows who’s currently editing. Under the hood, title, content, and excerptExcerptAn excerpt is the description of the blog post or page that will by default show on the blog archive page, in search results (SERPs), and on social media. With an SEO plugin, the excerpt may also be in that plugin’s metabox. now sync via Y.text for more granular conflictconflictA conflict occurs when a patch changes code that was modified after the patch was created. These patches are considered stale, and will require a refresh of the changes before it can be applied, or the conflicts will need to be resolved. resolution, and numerous reliability fixes address disconnection handling, revision restores, and performance metrics. (75286, 75398, 75065, 75448, 75595)
Gallery Lightbox Navigation
The Gallery block’s “Enlarge on click” lightbox now supports navigation between images. When you click an image in a gallery, back and next buttons let you browse through the rest of the gallery without closing the lightbox. Keyboard navigation with arrow keys and screen reader announcements (“Enlarged image X of Y”) are fully supported. Images that don’t have lightbox enabled (e.g., those linked to a file URLURLA specific web address of a website or web page on the Internet, such as a website’s URL www.wordpress.org) are skipped during navigation. (62906)
Other Notable Highlights
Block visibility enhancements: List View now shows viewport-aware icons with tooltips indicating which viewports a block is hidden on, and hidden blocks get a simplified toolbar. The keyboard shortcut (Cmd+Shift+H / Ctrl+Shift+H) to toggle block visibility options is featured in the block context menu. (75404, 75335, 75334)
Notes keyboard shortcut: You can now create a block note with Cmd+Option+M (Mac) or Ctrl+Alt+M (Windows/Linux), and press Escape to cancel. (75287, 75288)
Verse block renamed to Poetry: The Verse block is now called Poetry. (74121)
QuickEdit stabilized: QuickEdit is now stable and opens as a modal in the Site Editor pages view. (75565, 75173)
Text-align block support migrations: Eight blocks (Author Biography, Post Author Name, Post Comments Count, Post Comments Form, Post Comments Link, Post Terms, Post Time to Read, and Term Description) have been migrated to the standardized text-align block support.
Enforced iframeiframeiFrame is an acronym for an inline frame. An iFrame is used inside a webpage to load another HTML document and render it. This HTML document may also contain JavaScript and/or CSS which is loaded at the time when iframe tag is parsed by the user’s browser. for the post editor: Please check here for more information. (75475)
Many of these new features will also be included in the upcoming WordPress version 7.0, so you can find more details and testing instructions over at the 7.0 Call for Testing.
Changelog
Features
wp-env: Add –config option for custom configuration files. (75087)
Client Side Media
Add AVIF, WebP and MozJPEG output encoding support. (75081)
Add device/browser capabilitycapabilityA capability is permission to perform one or more types of task. Checking if a user has a capability is performed by the current_user_can function. Each user of a WordPress site might have some permissions but not others, depending on their role. For example, users who have the Author role usually have permission to edit their own posts (the “edit_posts” capability), but not permission to edit other users’ posts (the “edit_others_posts” capability). detection. (75863)
Add EXIF metadata tests for Client Side Media. (74909)
Add testsEnvironment option and split Gutenberg wp-env configs. (75341)
Adminadmin(and super admin)UIUIUser interface: Apply ‘text-wrap: Pretty’ to Page. (74907)
Commands: Display categoryCategoryThe 'category' taxonomy lets you group posts / content together that share a common bond. Categories are pre-defined and broad ranging. labels and enforce category icons. (75669)
Gutenberg plugin: Always enforce the iframe in the post editor. (75475)
Layout: Update Gutenberg to match coreCoreCore is the set of software required to run WordPress. The Core Development Team builds WordPress. after #75360 sync. (75594)
Media Utils: Auto-select uploaded files in media modal experiment. (75597)
MediaEdit: Support ordered values and reordering of items. (75207)
Replace install-path command with status command in wp-env. (75020)
Accordion: Move Accordion icons to Icon library. (75380)
Author block: When recreating, migrate the textAlign attribute of the Author block to the block style attribute. (75153)
Block Supports: Add Line Indent support using enum setting. (74889)
Blocks: Try prepending ‘httpsHTTPSHTTPS is an acronym for Hyper Text Transfer Protocol Secure. HTTPS is the secure version of HTTP, the protocol over which data is sent between your browser and the website that you are connected to. The 'S' at the end of HTTPS stands for 'Secure'. It means all communications between your browser and the website are encrypted. This is especially helpful for protecting sensitive data like banking information.’ to URLs without protocol. (75005)
Breadcrumbs: Improve loading state rendering. (75383)
Navigation Link: Clarify Link To invalidinvalidA resolution on the bug tracker (and generally common in software development, sometimes also notabug) that indicates the ticket is not a bug, is a support request, or is generally invalid. and draft states. (74054)
Navigation Link: Go to page link and edit page for inspector sidebarSidebarA sidebar in WordPress is referred to a widget-ready area used by WordPress themes to display information that is not a part of the main content. It is not always a vertical column on the side. It can be a horizontal rectangle below or above the content area, footer, header, or any where in the theme.. (75262)
theme.jsonJSONJSON, or JavaScript Object Notation, is a minimal, readable format for structuring data. It is used primarily to transmit data between a server and web application, as an alternative to XML.: Enable width setting for Icon block by default. (75665)
Editor: Introduce new selectedNote editor state. (75177)
FilterFilterFilters are one of the two types of Hooks https://codex.wordpress.org/Plugin_API/Hooks. They provide a way for functions to modify data of other functions. They are the counterpart to Actions. Unlike Actions, filters are meant to work in an isolated manner, and should never have side effects such as affecting global variables and output. navigation category patterns to only show in navigation-overlay template part context. (75276)
Add global setting to enable real-time collaboration. (75286)
Move PHPPHPThe web scripting language in which WordPress is primarily architected. WordPress requires PHP 7.4 or higher code to compat / backports directory. (75366)
DataForm: Mark fields as required or optional automatically. (74430)
Dataform: Adds validation support to the DataForm details layout. (74996)
Components
DataViews: Use public ColorPicker instead of internal Picker export. (75394)
DateCalendar, DateRangeCalendar: Use lighter gray for disabled dates. (75683)
ToggleGroupControl: Add visual emphasis to selected item. (75138)
[Real-time collaboration] Refine collaborator overlay with AvatarAvatarAn avatar is an image or illustration that specifically refers to a character that represents an online user. It’s usually a square box that appears next to the user’s name. component integration. (75595)
Fix missed dimension token migrationMigrationMoving the code, database and media files for a website site from one server to another. Most typically done when changing hosting companies. in UI package. (75446)
WidgetWidgetA WordPress Widget is a small block that performs a specific function. You can add these widgets in sidebars also known as widget-ready areas on your web page. WordPress widgets were originally created to provide a simple and easy-to-use way of giving design and structure control of the WordPress theme to the user. Area: Disable renaming and visibility support. (75279)
Writing flow: Fix Cmd+A from empty RichText. (75175)
iAPI Router: Update cached styles for re-fetched pages. (75097)
ui/Button: Fix disabled styles and variable composition. (75568)
wp-env Playground: Improve mapping and core source handling. (75527)
wp-env:
Fix MySQLMySQLMySQL is a relational database management system. A database is a structured collection of data where content, configuration and other options are stored. https://www.mysql.com startup race condition causing database connection errors. (75046)
Cover block: Force LTR direction for the background URL input field. (75169)
Featured ImageFeatured imageA featured image is the main image used on your blog archive page and is pulled when the post or page is shared on social media. The image can be used to display in widget areas on your site or in a summary list of posts.: Added a fallback to the default value when clearing the aspect ratio control for the Featured Image. (75358)
Fix duplicate content when navigation overlay is open and nav has non-link inner blocks. (75180)
Fix: Make all Navigation Overlay Close buttons work. (75384)
Fix: Show and hook up submenu visibility for Page Lists within Navigation Blocks. (75531)
Gallery: Fix PHP warning in random order image reordering. (75678)
Gallery: Skip interactivity directives when no images have lightbox enabled. (75680)
Media & Text: Respect image_default_link_type option. (74295)
Navigation Submenu: Restore openSubmenusOnClick to usesContext for backward compatibility. (75435)
Navigation block: Remove horizontal scroll from list view. (75086)
Navigation link: Fix resetting link from the tools panel. (75228)
Navigation overlay: Fix default pattern contrast issue on dark themes. (74979)
Post Excerpt: Disable HTMLHTMLHyperText Markup Language. The semantic scripting language primarily used for outputting content in web browsers. element insertion. (74928)
Pullquote: Fix deprecated block validation when anchor/id attribute is present. (75132)
Improve Tab Panel accessibilityAccessibilityAccessibility (commonly shortened to a11y) refers to the design of products, devices, services, or environments for people with disabilities. The concept of accessible design ensures both “direct access” (i.e. unassisted) and “indirect access” meaning compatibility with a person’s assistive technology (for example, computer screen readers). (https://en.wikipedia.org/wiki/Accessibility). (75484)
Fix sidebar display logic for small screens. (75454)
Real-time Collaboration: Fix revision restore bugbugA bug is an error or unexpected result. Performance improvements, code optimization, and are considered enhancements, not defects. After feature freeze, only bugs are dealt with, with regressions (adverse changes from the previous version) being the highest priority.. (75233)
Resize metaMetaMeta is a term that refers to the inside workings of a group. For us, this is the team that works on internal WordPress sites like WordCamp Central and Make WordPress. box pane without ResizableBox. (66735)
Sync post content and undefined blocks value. (75437)
Update the y-protocols version and remove the unnecessary diff types. (75657)
Use Y.text for title, content and excerpt. (75448)
Documentation
Clarifies cherry-picking permissions and improves minor releaseMinor ReleaseA set of releases or versions having the same minor version number may be collectively referred to as .x , for example version 5.2.x to refer to versions 5.2, 5.2.1, 5.2.3, and all other versions in the 5.2 (five dot two) branch of that software. Minor Releases often make improvements to existing features and functionality. workflow documentation. (75034)
Design System: Add guidelines for save and submit UXUXUser experience. (74811)
Docs: Add missing global documentation in block library. (75004)
Docs: Remove private GitHubGitHubGitHub is a website that offers online implementation of git repositories that can easily be shared, copied and modified by other developers. Public repositories are free to host, private repositories require a paid subscription. GitHub introduced the concept of the ‘pull request’ where code changes done in branches by contributors can be reviewed and discussed before being merged by the repository owner. https://github.com/ team links in repository management. (75255)
Docs: Rename Interactivity API’s ‘API Reference’ to ‘Directives and Store’. (74974)
Fix: Navigation Overlay Close Block: Add missing since tagtagA directory in Subversion. WordPress uses tags to store a single snapshot of a version (3.6, 3.6.1, etc.), the common convention of tags in version control systems. (Not to be confused with post tags.)#75247. (75250)
Core Data: Improve blocks cache in useEntityBlockEditor. (75400)
Docs: Add missing global documentation in rtl.php and meta-box.php. (75082)
Generate manifest PHP file based on JSON file. (75684)
Move experimental PR out of backportbackportA port is when code from one branch (or trunk) is merged into another branch or trunk. Some changes in WordPress point releases are the result of backporting code from trunk to the release branch. log. (75465)
Remove backport changelog committed by mistake. (75441)
Remove the ReactReactReact is a JavaScript library that makes it easy to reason about, construct, and maintain stateless and stateful user interfaces.
https://reactjs.org Native test status badges. (74674)
Restrict base-ui imports outside of UI component packages. (75143)
Select: Remove unnecessary jest.setTimeout from test. (75444)
Types: Consistently use the React namespace. (75499)
Remove unnecessary block deprecation from experimental tabs. (75208)
Storybook: Always load design tokens in Design System section. (74899)
Block Editor
Add l10nL10nLocalization, or the act of translating code into one's own language. Also see internationalization. Often written with an uppercase L so it is not confused with the capital letter i or the numeral 1. WordPress has a capable and dynamic group of polyglots who take WordPress to more than 70 different locales. context to ‘Manage allowed blocks’ string. (75239)
Real-Time Collaboration: Add end-to-end tests for RTC. (75598)
Testing
Add end-to-end test for loading settings in site editor preload spec. (75661)
Add end-to-end test for selection restoration after pattern navigation. (75575)
Add unit testunit testCode written to test a small piece of code or functionality within a larger application. Everything from themes to WordPress core have a series of unit tests. Also see regression. for gap in block style variations fix. (75038)
“What’s new in GutenbergGutenbergThe Gutenberg project is the new Editor Interface for WordPress. The editor improves the process and experience of creating new content, making writing rich content much simpler. It uses ‘blocks’ to add richness rather than shortcodes, custom HTML etc.
https://wordpress.org/gutenberg/…” posts (labeled with the #gutenberg-new tag) are posted following every Gutenberg release on a biweekly basis, showcasing new features included in each release. As a reminder, here’s an overview of different ways to keep up with Gutenberg and the Editor.
It brings practical refinements for your editing workflow. You can now add custom CSSCSSCascading Style Sheets. to individual blocks, and the Image blockBlockBlock is the abstract term used to describe units of markup that, composed together, form the content or layout of a webpage using the WordPress editor. The idea combines concepts of what in the past may have achieved with shortcodes, custom HTML, and embed discovery into a single consistent API and user experience. shows aspect ratio controls for wide and full alignments. List View gets more useful with full block titles and actual content displayed for list items. The release also stabilizes viewport-based block visibility and pattern editing, plus adds focal point controls for fixed Cover backgrounds and text column support for Paragraphs.
Table of contents
Custom CSS Support for Individual Blocks
Gutenberg 22.5 brings custom CSS support for individual block instances, letting you write styles that target specific blocks without affecting others of the same type. A has-custom-css class is automatically added in both the editor and frontend for dynamic blocks, making your custom styles easier to manage. If you’ve been working around this limitation with extra wrapper blocks or global CSS, your workflow just got simpler. (73959, 74969)
Image Block: Aspect Ratio Control for Wide and Full Alignment
The Image block now shows aspect ratio controls when you choose wide or full alignment. Previously, aspect ratio options only appeared for default-aligned images, a limitation when designing hero sections or full-width layouts. Now you can lock in your preferred proportions regardless of alignment, giving you more consistent control over how images display across different screen sizes (74519)
List View Improvements
Two enhancements make List View considerably more useful in this release. You’ll now see full block titles instead of truncated labels, and List Items display their actual content rather than generic “List Item” text. When you’re navigating complex documents with nested lists, these small changes make a real difference—you can finally tell your list items apart at a glance (74798, 74794)
Other Notable Highlights
Cover Block: Focal point picker for fixed backgrounds: You can now set a focal point even when using fixed/parallax backgrounds (74600).
Paragraph Block: Text column support: Paragraphs can now flow into multiple columns directly via block supports (74656).
Navigation: Submenus always open option: A new toggle lets you keep submenus permanently expanded rather than requiring hover/click (74653).
In-editor revisionsRevisionsThe WordPress revisions system stores a record of each saved draft or published update. The revision system allows you to see what changes were made in each revision by dragging a slider (or using the Next/Previous buttons). The display indicates what has changed in each revision. (initial implementation: Early groundwork for viewing revisions directly in the editor, though without “diffing” yet (74771).
Changelog
Enhancements
Block Library
Add custom CSS support for individual block instances. (73959)
Add the has-custom-css class name to the editor and dynamic blocks. (74969)
Allow for themes to define the overlay attribute without using a theme slug. (74119)
Image block: Show aspect ratio control for wide and full alignment. (74519)
List Item: Show content instead of block name in List View. (74794)
Navigation Overlay:
Add sidebarSidebarA sidebar in WordPress is referred to a widget-ready area used by WordPress themes to display information that is not a part of the main content. It is not always a vertical column on the side. It can be a horizontal rectangle below or above the content area, footer, header, or any where in the theme. preview. (74780)
Add a new option that toggles submenus always open. (74653)
Don’t use a nav tagtagA directory in Subversion. WordPress uses tags to store a single snapshot of a version (3.6, 3.6.1, etc.), the common convention of tags in version control systems. (Not to be confused with post tags.) for navigation blocks inside overlays. (74764)
Real-time collaboration: Add default HTTPHTTPHTTP is an acronym for Hyper Text Transfer Protocol. HTTP is the underlying protocol used by the World Wide Web and this protocol defines how messages are formatted and transmitted, and what actions Web servers and browsers should take in response to various commands. polling sync provider. (74564)
Real-time collaboration: Use relative positions in undo stack. (74878)
Bug Fixes
Core backportbackportA port is when code from one branch (or trunk) is merged into another branch or trunk. Some changes in WordPress point releases are the result of backporting code from trunk to the release branch. for gutenberg_filter_global_styles_post: Protect from KSES mangling. (74731)
DataForm: Sync ReactReactReact is a JavaScript library that makes it easy to reason about, construct, and maintain stateless and stateful user interfaces.
https://reactjs.org-level validation to native inputs on date fields. (74994)
DataViews: Use regular casing for bulk selection count. (74573)
Fix typo in comment for value change check. (74730)
ShortcodeShortcodeA shortcode is a placeholder used within a WordPress post, page, or widget to insert a form or function generated by a plugin in a specific location on your site.: Fix non-string attribute values being silently dropped. (74949)
Cover Block: Show current embed URLURLA specific web address of a website or web page on the Internet, such as a website’s URL www.wordpress.org in dialog. (74885)
Embed: Fix Flickr double-padding with responsive wrapper. (73902)
Fix : Image caption blur in Gallery block. (74063)
Fix: Add border-box sizing for verse block. (74722)
Inspector tabs: Reset tab selection if the selected tab is no longer present. (74682)
Make custom navigation overlay full width. (74559)
Media & Text: Revert “Fixed Media & Text Block – Image not rendered properly on frontend when inside stack (#68610)”. (74715)
Pattern Editing: Update template part to use tabs. (74793)
Post ExcerptExcerptAn excerpt is the description of the blog post or page that will by default show on the blog archive page, in search results (SERPs), and on social media. With an SEO plugin, the excerpt may also be in that plugin’s metabox. Block: Fix excerpt trimming logic to handle whitespace correctly. (74925)
Post Excerpt Block: Fix length limits for both Editor and Front and fix ellipsis consistency. (74140)
Show submenu colors but remove the word overlay. (74818)
fix: Video block: video URLs pasted without “https://” show broken media. (74964)
Block Editor
Allow grid layout to use theme blockGap values for columns calculation. (74725)
Block Editor Provider: Fix editor error for contributor role when client-side media experiment is active. (74680)
Direct drag: Fix glitching around scrolling. (74608)
Ensure grid column never exceeds parent’s width. (74795)
Fix missing onClose prop for InserterMenu. (74920)
Fix: Fit Text not working on calculated line heights. (74860)
Fix: Safari “Edit as HTMLHTMLHyperText Markup Language. The semantic scripting language primarily used for outputting content in web browsers.” for Fit Text deletes content. (74864)
Fix: Stretchy text issue when nested on flex containers. (73652)
List View: Ensure element exists in document before focusing. (74613)
Pattern Editing: Prevent double-click editing for template parts and synced patterns. (74755)
Calculate viewport based on iframeiframeiFrame is an acronym for an inline frame. An iFrame is used inside a webpage to load another HTML document and render it. This HTML document may also contain JavaScript and/or CSS which is loaded at the time when iframe tag is parsed by the user’s browser. size in resizable editor. (75156)
Collaboration
Real-time collaboration: Do not wrap persisted doc applied update in transaction. (74753)
Real-time collaboration: Pass non-cleaned (but merged) edits to SyncManager#update. (74912)
Sync: Refactor ProviderCreator signature to an object. (74871)
Interactivity APIAPIAn API or Application Programming Interface is a software intermediary that allows programs to interact with each other and share data in limited, clearly defined ways.
iAPI Router: Fix initial router regions with attachTo being duplicated after navigate(). (74857)
iAPI Router: Prevent router regions with data-wp-key from being recreated on navigation. (74750)
iAPI: Fix and refactor runtime initialization logic. (71123)
DataViews
Fix actions visibility on smaller viewpoints and for lone action with isPrimary as true. (74836)
Fix insert left and right handling in table layout for RTL languages. (74681)
Fix: Escape less-than character in HTML attributes to prevent block recovery errors. (74732)
Patterns
Restore pattern categoryCategoryThe 'category' taxonomy lets you group posts / content together that share a common bond. Categories are pre-defined and broad ranging. actions for user patterns. (74927)
Update performance results endpoint to codevitals.run. (74802)
Use fetch API for performance results logging. (74803)
Experiments
Route: Add notFound to public API and add route validation. (74867)
Media
Media Modal Experiment: Add a simple notices-based uploading state. (74965)
Collaboration
Real-time Collaboration: Add user and selection information to awareness. (74728)
Post Editor
Media Editor: Add a simple media editor package and integrate into the editor package. (74601)
Block Library
Don’t show overlay settings for navigation blocks that are inside oth…. (74408)
Documentation
Added Missing Global Documentation class-wp-rest-block-editor-settings-controller file. (74973)
Added Missing Global Documentation extensibleExtensibleThis is the ability to add additional functionality to the code. Plugins extend the WordPress core software.-site-editor file. (74868)
Badge: Use stories for “Choosing intent” doc. (74675)
DataViews: Update storybook to add more context. (74819)
Docs: Add missing @return tags to experimental functions. (74960)
Docs: Standardize use of @link tag for URL references in lib directory. (74984)
Update wp-build documentation to describe ‘wpPlugin.name’. (74741)
Updated Typo in Rest APIREST APIThe REST API is an acronym for the RESTful Application Program Interface (API) that uses HTTP requests to GET, PUT, POST and DELETE data. It is how the front end of an application (think “phone app” or “website”) can communicate with the data store (think “database” or “file system”)
https://developer.wordpress.org/rest-api/ File. (74718)
iAPI Docs: Add configuration to state/context guide. (71355)
iAPI: Don’t use deprecated data-wp-on-async in documentation. (72591)
iAPI: Update deprecation warning for unique ID format. (74580)
Move grid manual mode sync into 7.1 folder. (74792)
Update: Preserve additional metaMetaMeta is a term that refers to the inside workings of a group. For us, this is the team that works on internal WordPress sites like WordCamp Central and Make WordPress. properties on client side abilities. (73918)
Comments Title: Copy deprecate from block.jsonJSONJSON, or JavaScript Object Notation, is a minimal, readable format for structuring data. It is used primarily to transmit data between a server and web application, as an alternative to XML. to deprecated.js to avoid legacy attribute usage. (74924)
Add displayName to the anonymous components. (74716)
SlotFill: Unify registry and fill implementation. (68056)
Block Editor
Block Visibility: Fix failing unit testunit testCode written to test a small piece of code or functionality within a larger application. Everything from themes to WordPress core have a series of unit tests. Also see regression.. (74840)
Post Editor
Blocks: Always trigger borwser console warnings for blocks with apiVersion below 2. (74057)
e2e: Fix flaky tests for settings sidebar. (74929)
end-to-end tests: Bump all test blocks to API v3. (74941)
end-to-end tests: Remove switchToLegacyCanvas from multi select and a11yAccessibilityAccessibility (commonly shortened to a11y) refers to the design of products, devices, services, or environments for people with disabilities. The concept of accessible design ensures both “direct access” (i.e. unassisted) and “indirect access” meaning compatibility with a person’s assistive technology (for example, computer screen readers). (https://en.wikipedia.org/wiki/Accessibility) suite. (74845)
end-to-end tests: Remove switchToLegacyCanvas from inserter drag and drop tests. (74892)
eslint-pluginPluginA plugin is a piece of software containing a group of functions that can be added to a WordPress website. They can extend functionality or add new features to your WordPress websites. WordPress plugins are written in the PHP programming language and integrate seamlessly with WordPress. These can be free in the WordPress.org Plugin Directory https://wordpress.org/plugins/ or can be cost-based plugin from a third-party.: Add “never” option for dependency-group rule. (74990)
selectBlock: Fall back to next block if no previous block is present. (74938)
Build Tooling
Build script: Increase memory limit for storybook build process. (74933)
Build: Deduplicate and minify embedded styles. (74651)
Icons: Add a manifest containing icons metadata. (74943)
“What’s new in GutenbergGutenbergThe Gutenberg project is the new Editor Interface for WordPress. The editor improves the process and experience of creating new content, making writing rich content much simpler. It uses ‘blocks’ to add richness rather than shortcodes, custom HTML etc.
https://wordpress.org/gutenberg/…” posts (labeled with the #gutenberg-newtagtagA directory in Subversion. WordPress uses tags to store a single snapshot of a version (3.6, 3.6.1, etc.), the common convention of tags in version control systems. (Not to be confused with post tags.)) are posted following every Gutenberg release on a biweekly basis, showcasing new features included in each release. As a reminder, here’s an overview of different ways to keep up with Gutenberg and the Editor.
This release covers typography, patterns, images, and responsive design. The Font Library now works with classic and hybrid themes. Pattern Overrides expanded to custom blocks. The Image blockBlockBlock is the abstract term used to describe units of markup that, composed together, form the content or layout of a webpage using the WordPress editor. The idea combines concepts of what in the past may have achieved with shortcodes, custom HTML, and embed discovery into a single consistent API and user experience. got focal point controls. And there’s an experimental feature for hiding blocks based on screen size.
Classic and Hybrid Theme Support for the Font Library
The Font Library and Global Styles now work with classic themes (#73971, #73876). Like the Media Library, you can access the Font Library as a modal or through a dedicated adminadmin(and super admin) section—regardless of your theme type.
Pattern Overrides: Custom Block Support
Custom blocks can now use Pattern Overrides. (#73889)
Since WordPress 6.5, Pattern Overrides let you create synced patterns where the layout stays consistent but specific content can change per instance. The catch? Only four coreCoreCore is the set of software required to run WordPress. The Core Development Team builds WordPress. blocks supported it: Heading, Paragraph, Button, and Image.
Not anymore. Any block attribute that supports Block Bindings now supports Pattern Overrides by default. Block authors can opt in through the server-side block_bindings_supported_attributesfilterFilterFilters are one of the two types of Hooks https://codex.wordpress.org/Plugin_API/Hooks. They provide a way for functions to modify data of other functions. They are the counterpart to Actions. Unlike Actions, filters are meant to work in an isolated manner, and should never have side effects such as affecting global variables and output.. This closes a long-requested enhancement and opens up synced patterns to custom blocks.
Image Block: Focal Point Controls
The Image block now has focal point controls. (#73115) Set a focal point on any image to control which part stays visible when the image is cropped for different screen sizes or aspect ratios. The picker is built into the Image block settings, so you can adjust it without leaving the editor.
Block Visibility Based on Screen Size (Experimental)
A new experimental feature lets you hide or show blocks based on screen size. (#73949, #74249, #74379)
Site builders have been asking for this forever—control block visibility across devices without writing CSSCSSCascading Style Sheets.. The feature includes a viewport modal for setting visibility rules, backend support for generating CSS, and visual indicators showing which blocks are hidden at different screen sizes. It’s experimental for now and requires enabling the experiment flag.
Other Notable Highlights
A few more highlights worth mentioning:
Real-Time Collaboration is no longer experimental. (#74562) The code has moved out of experimental status ahead of planned inclusion in WordPress 7.0. Note that a default provider isn’t in place yet.
Verse and Quote blocks can now transform into each other. (#73068) Finally fixes the annoyance of similar blocks not being interchangeable.
Dimension presets for width and min-height. (#73811) Theme developers can define preset dimension values in theme.jsonJSONJSON, or JavaScript Object Notation, is a minimal, readable format for structuring data. It is used primarily to transmit data between a server and web application, as an alternative to XML. that appear when users set block widths or minimum heights.
Query LoopLoopThe Loop is PHP code used by WordPress to display posts. Using The Loop, WordPress processes each post to be displayed on the current page, and formats it according to how it matches specified criteria within The Loop tags. Any HTML or PHP code in the Loop will be processed on each post. https://codex.wordpress.org/The_Loop block can exclude terms. (#73790) Much easier than the old workaround of manually adding every term except the one you don’t want.
Paragraph block supports wide and full alignment. (#73958) Useful for theme developers working with wide and full alignment CSS in block layouts.
Notes appear even when template lock is enabled. (#74577) The Notes feature (added in WordPress 6.9) now shows up regardless of template lock mode.
Changelog
Features
Collaboration
Real-time collaboration: Move collaborative editing from experiments to default Gutenberg pluginPluginA plugin is a piece of software containing a group of functions that can be added to a WordPress website. They can extend functionality or add new features to your WordPress websites. WordPress plugins are written in the PHP programming language and integrate seamlessly with WordPress. These can be free in the WordPress.org Plugin Directory https://wordpress.org/plugins/ or can be cost-based plugin from a third-party. experience. (74562)
Add autoComplete attribute to prevent browser autocomplete. (74595)
Add list view inspector tab for pattern editing. (74574)
Block Inspector: Update the design of the style variation to use ToolsPanel. (74224)
Block variation transformation: Change position and threshold. (74251)
ContentOnlyControls: Polish headerHeaderThe header of your site is typically the first thing people will experience. The masthead or header art located across the top of your page is part of the look and feel of your website. It can influence a visitor’s opinion about your content and you/ your organization’s brand. It may also look different on different screen sizes. style. (74260)
Enhance Notice actions to allow more props like disabled and onClick with URLURLA specific web address of a website or web page on the Internet, such as a website’s URL www.wordpress.org. (74094)
Preview drop down: Align preview editing widths with common breakpoints. (74339)
Block APIAPIAn API or Application Programming Interface is a software intermediary that allows programs to interact with each other and share data in limited, clearly defined ways.
Annotations: Maintain active formats after applying. (73575)
Block Bindings: Remove caption from edit on EditWithGeneratedProps. (73552)
Command Palette: Fix in the font library page and site editor experiment. (74232)
Core Merge: Deduplicate Font Library page and routes. (74381)
Customize: Preserve CSS cascade for Additional CSS in classic themes. (74593)
DataForm: Fix panel field inaccessible when empty with labelPosition none or top. (74264)
Fix document title htmlHTMLHyperText Markup Language. The semantic scripting language primarily used for outputting content in web browsers. entities. (74027)
Fix punctuation and formatting in README.md. (74440)
Fix the dataviews experiment locked fields position on toggle. (74326)
Fix: Menu_order validation to allow zero and negative values. (74282)
Font Library: Allow the sidebarSidebarA sidebar in WordPress is referred to a widget-ready area used by WordPress themes to display information that is not a part of the main content. It is not always a vertical column on the side. It can be a horizontal rectangle below or above the content area, footer, header, or any where in the theme. to be scrolled in boot powered pages like fonts. (73960)
Image Cropper package: Add reactReactReact is a JavaScript library that makes it easy to reason about, construct, and maintain stateless and stateful user interfaces.
https://reactjs.org peer dependencies. (74402)
Preferences: Add TypeScript types to package.json exports. (73276)
Theme: Fix design-tokens.js entrypoint to specify types and CJS variants. (74129)
[create-block] Updates variant handling for missing directory files. (73986)
api-fetch: Add named export to fix TypeScript callable issues. (74576)
Editor: Remove extra comma from offline error notices. (73907)
Scroll to previous location in document with editor back button. (73737)
Block Library
Block Fields: Remove normalization code and tidy up. (74532)
Block Library: Fix discussion settings data selection. (74026)
Categories Block: Fix CSS collision with labels. (73862)
Comments Title Block: Fix double quotes in non-English locales. (74330)
Remove block selection clearer handling from iframeiframeiFrame is an acronym for an inline frame. An iFrame is used inside a webpage to load another HTML document and render it. This HTML document may also contain JavaScript and/or CSS which is loaded at the time when iframe tag is parsed by the user’s browser.. (73753)
Replace default block on paste if it has no content. (73951)
Rich Text: Make inline toolbar more reactive for proper positioning. (73853)
WidgetWidgetA WordPress Widget is a small block that performs a specific function. You can add these widgets in sidebars also known as widget-ready areas on your web page. WordPress widgets were originally created to provide a simple and easy-to-use way of giving design and structure control of the WordPress theme to the user. Group: Remove parent outline. (74107)
Fix: Align Document Outline padding in List View sidebar to match surrounding panels (#73576). (73595)
Global Fonts: Convert relative font URLs to absolute theme URLs in font-face styles. (74115)
Global Fonts: Correctly convert relative font URLs to absolute theme URLs in font-face styles. (74137)
Site editor global styles settings: Ensure generated global styles are correct in canvas between views. (73952)
Site editor global styles settings: Preserve non-global styles in default site editor settings. (74088)
Theme_JSON_Resolver: Defensively cover against situations where the post is null. (74124)
Components
Add checkerboard pattern for background in featured imageFeatured imageA featured image is the main image used on your blog archive page and is pulled when the post or page is shared on social media. The image can be used to display in widget areas on your site or in a summary list of posts. preview. (74091)
Fix DateTimePicker timezone handling for non-string values. (73887)
Fix InputControl label overflow for long translations. (74301)
Improve memoization in the overrides panel. (74407)
Fix bindableAttributes only being returned for the selected block. (74061)
AccessibilityAccessibilityAccessibility (commonly shortened to a11y) refers to the design of products, devices, services, or environments for people with disabilities. The concept of accessible design ensures both “direct access” (i.e. unassisted) and “indirect access” meaning compatibility with a person’s assistive technology (for example, computer screen readers). (https://en.wikipedia.org/wiki/Accessibility)
Block Editor
Update: Use 12px as minimum font size for warning on fit text. (74387)
@wordpress/keycodes: Add ariaKeyShortcut and shortcutFormats exports. (74205)
Stretchy Text: Accept very small font sizes, and show a warning. (73730)
Components
Validated form controls: Suppress native popover. (73471)
Performance
Block Library
Blocks: Cache URL root when registering assets. (74451)
Add experiment for hiding blocks based on screen size. (73949)
Block Visibility: Fix block position shift when toggling. (74535)
Block visibility: Incorrect argument passed to hasBlockSupport in isBlockHidden. (74151)
Block visibility based on screen size: Add backend block support. (73994)
Block visibility support: Use CSS range syntax for media queries. (74526)
Block visibility based on screen size: Add rules to hide on viewport size. (74379)
Block visibility: Add viewport modal and controls UI. (74249)
Block visibility: Add visibility notice for hidden blocks in the block inspector. (74180)
Block visibility based on screen size: Basic clientside state. (74025)
Block Library
PHPPHPThe web scripting language in which WordPress is primarily architected. WordPress requires PHP 7.4 or higher-only blocks: Generate inspector controls from attributes. (74102)
PHP-only blocks: Use HtmlRenderer to ensure fontend & editor consistency. (74261)
Refine overlay edit button UI: Move to link variant and add tooltip. (73957)
Render custom overlay template parts in Navigation block (behind experiment). (73967)
Update navigation-overlay-close block to be used as server side rendering. (74579)
Add Navigation Overlay close block (behind experiment). (73724)
Add create new overlay button to Navigation block. (73919)
Navigation Overlay: Fix area and icon name. (74520)
Real-time collaboration: Add type guard for rich-text attributes. (73946)
Real-time collaboration: Fix persisted document metaMetaMeta is a term that refers to the inside workings of a group. For us, this is the team that works on internal WordPress sites like WordCamp Central and Make WordPress. and add tests. (73985)
Real-time collaboration: Improve type safety with YMapWrap. (73948)
Real-time collaboration: Use alternative diff in quill-delta, provide incremental text updates. (73699)
Real-time collaboration: Allow post-locked-modal to be overridden when collaborative-editing is enabled. (72326)
Create a reverse map for faster itemBlock lookups. (73930)
Site Editor
Add extensibleExtensibleThis is the ability to add additional functionality to the code. Plugins extend the WordPress core software. site editor experiment. (74123)
Extensible Site Editor: Design improvements and page rename. (73962)
Extensible Site Editor: Fix the dashboard link. (74231)
Extensible Site Editor: Lift template activation restriction. (74197)
Build: Rename extensible site editor page to avoid conflicts. (74221)
Extensible Site Editor: The Canvas should share the same ThemeProvider as all the surfaces. (74125)
Routing: Add title support to php generated pages. (73877)
Docs: Fix callout notices layout and clarify GitHubGitHubGitHub is a website that offers online implementation of git repositories that can easily be shared, copied and modified by other developers. Public repositories are free to host, private repositories require a paid subscription. GitHub introduced the concept of the ‘pull request’ where code changes done in branches by contributors can be reviewed and discussed before being merged by the repository owner. https://github.com/ vs handbook links. (74252)
Enhance Block Bindings Documentation as per WP 6.9 updates: Customizing supported attributes an getFieldsList. (73763)
Fix documentation title for wordpress/build package. (74541)
Fix formatting in block bindings documentation: Corrected links to core sources by adding hyphens. (74414)
Fix invalidinvalidA resolution on the bug tracker (and generally common in software development, sometimes also notabug) that indicates the ticket is not a bug, is a support request, or is generally invalid. theme.json color value in Global Styles documentation. (73999)
Fix typo in Tutorial: Build your first block. (74050)
Update the copyright licensecopyright licenseCopyright holders may grant a license with various allowances including the ability to modify or distribute the copyrighted material. Also see GPL. to 2026. (74306)
Update the useCommandLoader example to fix the syntax error and add missing imports. (73660)
Validated form controls: Add stories for validation in popovers. (71282)
Code Quality
wordpress/theme: Update color ramp generation snapshots. (74281)
Fix: Use WP_Theme_JSON_Gutenberg instead of WP_Theme_JSON class. (74294)
Theme: Enable color ramp tests and update snapshots. (74403)
TypeScript: Convert notices package to TypeScript. (67670)
TypeScript: Migrate packages/jest-puppeteer-axe package to TypeScript. (70523)
TypeScript: Migrate shortcodeShortcodeA shortcode is a placeholder used within a WordPress post, page, or widget to insert a form or function generated by a plugin in a specific location on your site. package to TS. (74522)
Block support: BackportbackportA port is when code from one branch (or trunk) is merged into another branch or trunk. Some changes in WordPress point releases are the result of backporting code from trunk to the release branch. anchor support changes in core. (74341)
Plugin
Bump minimum required WordPress version to 6.8. (74218)
Template Activation: Try fixing still flaky test. (74216)
Test: Update URLs in tests to use example.org/com instead of test.com. (74246)
Tests: Add unit tests for Button block __experimentalLabel functionality. (74186)
Theme: Ensure build artifacts are synced in version controlversion controlA version control system keeps track of the source code and revisions to the source code. WordPress uses Subversion (SVN) for version control, with Git mirrors for most repositories.. (73894)
end-to-end tests: Restore removal of settings path in preload tests. (74375)
wordpress/theme: Disable color ramp unit tests. (74347)
Template Activation: Make template edit test less flaky again. (74066)
Template Activation: Make template edit test less flaky. (73975)
Data Layer
Cleanup the dependencies in the root package.json. (74212)
Update package version after an unfinished publish. (74413)
npm Packages
Packages: Add support for publishing stable release of pre-release package. (74332)
Packages: Avoid bumping the major version on prerelease packages. (74285)
You must be logged in to post a comment.