drupal 11.3.0

This is a a feature minor release of Drupal 11 and is ready for use on production sites. Learn more about the latest version of Drupal and the Drupal core release cycle.

Read the Drupal 11.3.0 release announcement for improvements and highlights in this release.

This minor release provides improvements and new functionality. It does not break backward compatibility (BC) for public APIs. There may be changes in internal APIs and experimental modules. If so, contributed and custom modules and themes may need updating. This is according to Drupal core's backward compatibility and experimental module policies.

This release may include string changes and additions. Translators can review the latest translation status on localize.drupal.org.

Drupal 11.3.x will receive security support until December 2026. Drupal 11.2.x will continue to receive security support until June 2026.

Drupal 11 will be supported until the release of Drupal 13.

Important update information

Permission changes

• A new permission "Administer node published status" allows content editors to change the publication status of all content types without being able to edit the content.
• A new permission "Rebuild node access permissions" restricts who can rebuild the node access grants, as this can be a long and disruptive process.

Neither of these permissions will be granted by default (except to administrators who have all permissions) but you may wish to review your permission setup if these features are relevant to your site.

Navigation is now stable

The Navigation module is now stable and safe for use on production sites. Navigation provides a collapsible, vertical sidebar for Drupal's administrative user interface. It is a significant improvement for Drupal's administrative user experience.

Navigation will replace Drupal's existing Toolbar in the Standard profile in a future release, but there are known major and critical bugs that must be resolved first, including known accessibility issues:

• #3541728: Submenu opened with hover does not close by Escape key when another menu item has focus
• #3541910: Elements in closed sidebar are focusable
• #3443571: Mobile version of Navigation should have focus trap
• #3443830: Navigation layout Drag is not working in some browers
• #3542774: The “reduce motion” setting in the operating system should be respected

Platform requirements changes

• PHP 8.4 is now the recommended PHP version for sites using Drupal 11 versions 11.3 and above. (PHP 8.3 is still the minimum supported version.)

• Support for hosting Drupal directly on Windows in production environments is deprecated. Windows is not a well supported environment, we do not have an automated Windows test environment and there are few developers who can test on Windows. Therefore, sites wanting to use Windows servers in production should plan to use Linux on Windows.

  Support for Windows in development environments will continue.

API and behavior changes

• The Promoted to frontpage checkbox on the Node Type form now defaults to unchecked. This change affects new content types only.

• Themes now support OOP hooks. Themes that use includes from within their .theme file may need to update in some cases.

Deprecated modules

The Ban core module is deprecated in Drupal 11.3.0 and will be moved to contributed projects in Drupal 12.

Additional modules may be deprecated prior to Drupal 12.

PHP dependency changes

• The doctrine/annotations package is marked abandoned upstream. Parts of the code have been forked into Drupal core. This change only affects custom code that was handling PHP annotations; for more information, see the change record.

• Symfony components have been updated to Symfony v7.4.0.

Many dependencies have also received minor- and patch-level updates to the latest versions.

Frontend (CSS and JavaScript) production dependency changes

• CKEditor has been updated to CKEditor v47.3.0.

Many dependencies have also received minor- and patch-level updates to the latest versions.

Development dependencies

• Framework support for testing with PHPUnit 10 is removed. Both core and contrib can now only run tests with PHPUnit 11.

• Test classes using annotation metadata still work under PHPUnit 11, but throw PHPUnit deprecations that lead to CI job failures if appropriately set up. It is strongly recommended to convert annotations to attributes as described in Tests with PHPUnit 10 attributes are now supported.

Many dependencies have received minor- and patch-level updates to the latest versions.

Known issues

• #3562753: History module triggers ServiceNotFoundException for comment.manager when Comment module is not enabled
• #3560487: Gin Top Bar styling is fully gone in 11.3.x

(affects the contributed Gin theme)

Search the issue queue for known issues.

All changes since Drupal 11.3.0-rc2

• fix: #3446368 SymfonyMailer RfcComplianceException when sending to multiple comma-separated addresses
• fix: #3558939 options_config_install_test has unnecessary Body field
• fix: #3559059 Add UserAuthenticationInterface alias to user.auth service
• docs: #3496417 Fix PHPStan missingType.generics for FieldItemListInterface not specifying its type
• task: #3549727 Fix LongLineDeclaration in module Controller, Hook and Database directories