Drupal 11.3.1
2 January 2026
Drupal version 11.3.1 is now available (major release).
Upgrading to Drupal 11.3.1
Drupal 11.3.1 can be upgraded to (or installed) using any of Installatron's products. Use Installatron's optional Automatic Update feature to automatically apply Drupal updates as new versions are released, or use Installatron's Clone feature to duplicate an existing Drupal install to test the 11.3.1 upgrade prior to applying it live. Get started managing your Drupal installations with Installatron
What's New in Drupal 11.3.1
11.3.1
Bug Fixes
- #3562753 History module triggers ServiceNotFoundException for comment.manager when Comment module is not enabled
- #3563876 TypeError: trigger_error(): Argument #2 () must be of type int, string given in trigger_error()
11.3.0
Highlights
- Major performance improvements: Significant reductions in database queries and cache operations, allowing sites to handle approximately 26–33% more requests with similar database load.
- Native HTMX support: HTMX is now integrated into core, enabling dynamic user interfaces with up to 71% less JavaScript.
- Navigation module stabilized: A modern replacement for the classic admin toolbar, designed for complex administration needs.
- Enhanced content editing experience: Improved CKEditor internal content linking with autocomplete, better list formatting options, new permission to manage published status without full node administration rights.
- Object-oriented hooks for themes: Themes can now use PHP attributes (#[Hook()]) for cleaner, more structured code.
- Native content export tool: New CLI tool in core to export content along with referenced dependencies.
- PHP 8.5 support: Full compatibility added, preparing for Drupal 12 requirements.
- Experimental MySQL/MariaDB driver: New mysqli-based driver enabling future support for parallel database queries.
Important Changes
- Permission change: 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. This permission 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.
- Permission change: A new permission "Rebuild node access permissions" restricts who can rebuild the node access grants, as this can be a long and disruptive process. This permission 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.
- Platform requirements change: 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.)
- Platform requirements change: 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.
- API and behavior change: The Promoted to frontpage checkbox on the Node Type form now defaults to unchecked. This change affects new content types only.
- API and behavior change: Themes now support OOP hooks. Themes that use includes from within their .theme file may need to update in some cases.
- Deprecated module: The Ban core module is deprecated in Drupal 11.3.0 and will be moved to contributed projects in Drupal 12.
- PHP dependency change: 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.
- PHP dependency change: Symfony components have been updated to Symfony v7.4.0.
- Frontend (CSS and JavaScript) production dependency change: CKEditor has been updated to CKEditor v47.3.0.