WordPress Release: 6.3.1

TL;DR

WordPress 6.3.1: Critical Bug Fixes and Stability Improvements

WordPress 6.3.1 is a maintenance release that addresses several critical bugs found in version 6.3. This update fixes editor crashes related to footnotes and cut-and-paste operations, resolves update issues for sites running WordPress 5.7 or earlier, corrects navigation menu conversion errors, and fixes Site Health disk space detection problems. The release ensures better stability and compatibility, particularly for the block editor and core WordPress functionality.

Highlight of the Release

• Fixed critical editor crashes related to footnotes and cut-and-paste operations
• Resolved update issues for sites running WordPress 5.7 or earlier
• Corrected navigation menu conversion error handling
• Fixed Site Health disk space detection for systems with large available space
• Improved user query handling to prevent fatal errors on single sites

Migration Guide

No migration steps are required for this maintenance release. WordPress 6.3.1 is a bug fix release that maintains compatibility with existing themes, plugins, and customizations.

To update to WordPress 6.3.1:

1. Back up your website before updating
2. Update through your WordPress dashboard or download the update from wordpress.org
3. Review your site functionality after the update to ensure everything is working as expected

Upgrade Recommendations

This update is highly recommended for all WordPress 6.3 users due to the critical bug fixes it contains. The release addresses several issues that could cause editor crashes, update failures, and incorrect site health reporting.

Sites running WordPress 5.7 or earlier that plan to update to version 6.3 should update directly to 6.3.1 to avoid the update issues fixed in this release.

As with any WordPress update, it's recommended to:

1. Create a complete backup of your site before updating
2. Test the update on a staging environment if possible
3. Update plugins and themes to their latest versions
4. Check site functionality after updating

Bug Fixes

Editor Fixes

• Fixed critical crashes related to footnotes functionality
• Resolved editor styles-related crashes
• Fixed cut and paste-related crashes in the block editor
• Updated npm packages with critical bug fixes

Core WordPress Fixes

• Reverted the use of str_starts_with() in update-core.php to fix updating from WordPress 5.7 and earlier versions
• Corrected error handling when converting classic menus to block menus
• Fixed the logic for switch_to_blog() in WP_User_Query::generate_cache_key() to prevent fatal errors when using specific query parameters on single sites
• Corrected the check for available disk space in Site Health to properly handle systems with large amounts of free space (over 2GB on 32-bit PHP)
• Fixed documentation for the wp_min_priority_img_pixels hook reference

New Features

No significant new features were introduced in this maintenance release. WordPress 6.3.1 focuses on bug fixes and stability improvements to address issues discovered in the 6.3 release.

Security Updates

No specific security fixes were mentioned in the release notes. This update primarily focuses on bug fixes and stability improvements rather than security vulnerabilities.

Performance Improvements

This release includes minor performance improvements:

• Optimized logic in Site Health to skip unnecessary checks when disk space information cannot be determined
• Prevented unnecessary calls to switch_to_blog() on single site installations, improving performance of certain user queries

Impact Summary

WordPress 6.3.1 is a maintenance release that addresses several critical bugs affecting the core functionality and stability of WordPress 6.3. The most significant impacts include:

1. Improved Editor Stability: Fixes for critical crashes related to footnotes, editor styles, and cut-and-paste operations ensure a more reliable content creation experience.

2. Better Update Compatibility: By reverting the use of PHP 8 functions in update processes, sites running on older WordPress versions (5.7 and earlier) can now successfully update without errors.

3. Enhanced Error Handling: Improved error handling for navigation menu conversion prevents potential issues when converting classic menus to block menus.

4. More Accurate Site Health: Correction of the disk space detection logic ensures accurate reporting in Site Health, particularly for systems with large amounts of available space.

5. Prevented Fatal Errors: Fixed logic in user queries prevents fatal errors on single site installations when using specific query parameters.

This release demonstrates WordPress's commitment to stability and backward compatibility, addressing issues quickly to ensure a smooth experience for all users.