Drupal 11 Migration Guide

Upgrade YMCA Website Services from Drupal 10 to Drupal 11.

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 module
  • inline_entity_menu_form module
  • bartik and seven themes
  • panelbutton 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:

  1. Update to latest Drupal 10: Ensure you’re on Drupal 10.3.x or higher
  2. Upgrade PHP: Update server to PHP 8.3 or higher
  3. Backup everything: Database, files, and code
  4. 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?

Need professional assistance?


Additional Resources