Drupal 11 Migration Guide
Overview
YMCA Website Services 11.1.0.0-beta1 brings compatibility with Drupal 11, released September 23, 2024. This is currently a beta release for early adopters and testing. A stable release is targeted for Q4 2025.
What’s New in Drupal 11
From the 11.1.0.0-beta1 release notes:
Major Platform Upgrades:
- Drupal 11 core upgrade
- PHP 8.3+ requirement (Symfony 7 integration)
- Composer-only module management (module upload UI removed)
New Development Features:
- Single Directory Components (SDC) for streamlined UI component development
- Object-Oriented Hooks (class-based hooks replacing procedural)
- New Icon Management API
- Native WebP image support
Content Editor Improvements:
- Project Browser for visual module installation
- Workspaces module for content staging
- Experimental new admin navigation system
Removed/Deprecated:
ckeditor
(replaced by CKEditor 5)ckeditor5_font
moduleinline_entity_menu_form
modulebartik
andseven
themespanelbutton
module
For complete release details, see 11.1.0.0-beta1 on GitHub.
Before You Upgrade
Important: This is a beta release. Only upgrade if:
- You’re testing for bugs before the stable Q4 2025 release
- You have a staging environment for testing
- You’re comfortable troubleshooting potential issues
Most YMCAs should remain on Drupal 10 until the stable Drupal 11 release in Q4 2025.
Prerequisites
Before upgrading to Drupal 11:
- Update to latest Drupal 10: Ensure you’re on Drupal 10.3.x or higher
- Upgrade PHP: Update server to PHP 8.3 or higher
- Backup everything: Database, files, and code
- Test on staging: Never upgrade production directly
Known Issues
jQuery 3.x Script Compatibility
Issue: Drupal 11 uses jQuery 3.x, which breaks some legacy jQuery 1.x/2.x scripts.
Solution: As of version 11.1.0.0-alpha2, YMCA Website Services includes jQuery Migrate to provide backward compatibility.
What this means:
- Legacy jQuery syntax (jQuery 1.x/2.x) continues to work with jQuery 3.x
- Custom JavaScript and third-party libraries maintain compatibility
- No immediate action required for most sites
For developers with custom JavaScript:
- Test your custom modules with jQuery 3.x
- Update deprecated jQuery methods when possible
- jQuery Migrate provides console warnings about deprecated code
References:
Getting Help
Testing Drupal 11 beta?
- Report bugs in the GitHub issue queue
- Join YMCA Website Services Slack for community support
- Attend monthly community calls for Q&A
Need professional assistance?
- Agency Partner Directory - Find certified partners who can help with upgrades