Drupal 11 Migration Guide

Upgrade YMCA Website Services from Drupal 10 to Drupal 11.
Tags:

Overview

YMCA Website Services 11.1.0.0 is the first stable release with Drupal 11 compatibility, released November 18, 2025. This release brings modern architecture, improved performance, and enhanced capabilities for YMCA organizations.

All major components including Activity Finder 6.0.0 and Memberships 3.1.0 have full Drupal 11 support, making this release production-ready.

What’s New in Drupal 11

From the 11.1.0.0 stable release:

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:

Before You Upgrade

Production Ready: Version 11.1.0.0 is a stable release suitable for production use. However:

  • Always test first: Upgrade staging/testing environments before production
  • Create backups: Ensure you have complete backups before upgrading
  • Review changes: See the Full Changelog for detailed changes
  • Plan accordingly: Major version upgrades require planning and testing

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 4.x Script Compatibility

Issue: Drupal 11 uses jQuery 4.x, which may affect some legacy jQuery 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/3.x) continues to work with jQuery 4.x via jQuery Migrate
  • 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 4.x
  • Update deprecated jQuery methods when possible
  • jQuery Migrate provides console warnings about deprecated code

References:

Getting Help

Upgrading to Drupal 11?

Need professional assistance?

Additional Resources

Last modified November 18, 2025: feat: Add 11.1.0.0 release documentation and update references (2ae546894)