WordPress Release: 6.5.4

TL;DR

WordPress 6.5.4 brings important fixes to plugin activation behavior

WordPress 6.5.4 restores the pre-6.5 plugin activation behavior, fixing a regression that affected plugin onboarding experiences. The update addresses issues with the plugin dependencies feature and improves development tooling. This maintenance release is particularly important for site administrators who rely on plugin configuration workflows and developers working with the WordPress testing environment.

Highlight of the Release

• Restored pre-6.5 plugin activation behavior to fix regression affecting plugin onboarding experiences
• Fixed plugin dependencies detection for newly installed plugins
• Improved development tooling with updated Docker configuration and GitHub workflows
• Enhanced E2E testing compatibility with older WordPress versions

Migration Guide

No migration steps are required for this maintenance release. The update restores expected behavior from pre-6.5 versions, making the experience more familiar to users who were accustomed to the previous plugin activation workflow.

Upgrade Recommendations

This update is recommended for all WordPress 6.5.x users, particularly those who:

• Manage sites with multiple plugins
• Rely on plugin configuration workflows after activation
• Use plugins with dependencies
• Work in WordPress development environments

The update addresses important regressions in plugin activation behavior and improves development tooling. As a maintenance release, it focuses on fixes rather than new features, making it a low-risk update that improves stability.

Bug Fixes

Plugin Activation Behavior

• Restored the Activate button's href native behavior by changing the AJAX activation handler introduced in 6.5.0
• Fixed regression that affected plugins with important onboarding/configuration experiences
• Reverted admin notice on successful activation that was added in 6.5.3 as it's no longer needed with the restored behavior

Plugin Dependencies

• Fixed issue with dependency detection for newly installed plugins
• Added initialization call in the AJAX callback before checking plugin dependencies
• Resolved false positive dependency checks that could lead to activation failures

New Features

No significant new features were added in this maintenance release. WordPress 6.5.4 focuses on bug fixes and improvements to existing functionality.

Security Updates

No security fixes were included in this maintenance release.

Performance Improvements

No specific performance improvements were included in this release. The changes focus on fixing functionality rather than performance enhancements.

Impact Summary

WordPress 6.5.4 addresses a significant regression introduced in 6.5.0 that affected plugin activation behavior. The previous implementation changed how the Activate button worked, breaking expected workflows for plugins that rely on redirecting users to configuration pages after activation.

This release restores the pre-6.5 behavior, allowing the Activate button to follow its native href behavior and properly redirect users to the plugin's configuration page when needed. This change is particularly important for plugin authors and site administrators who rely on proper onboarding experiences.

Additionally, the release fixes issues with the plugin dependencies feature, ensuring that dependencies are properly detected for newly installed plugins. This prevents false positive dependency checks that could lead to confusing activation failures.

For developers, the release includes several improvements to the development environment, including updated Docker configurations, GitHub workflow enhancements, and fixes for E2E testing with the Gutenberg plugin on older WordPress versions.

Overall, this maintenance release improves compatibility and reliability without introducing new features or breaking changes.