This is the multi-page printable view of this section. Click here to print.

Return to the regular view of this page.

Drupal 11 Migration Guide

Upgrade YMCA Website Services from Drupal 10 to Drupal 11.

    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

    ⚠️ Critical: Google Analytics Module Deprecation

    IMPORTANT: The google_analytics module is deprecated and will not be available in Drupal 11.2+. You must migrate to google_tag module before upgrading past Drupal 11.1.

    Why This Matters

    • The google_analytics module is being removed from Drupal core
    • The google_tag module will remain available and is the recommended replacement
    • Drupal 11.1 is the last version where migration path from google_analytics to google_tag is supported

    If You Skip This Step

    If you upgrade directly to Drupal 11.2 or later without migrating:

    • ❌ The google_analytics module will not be available
    • ❌ Your existing Google Analytics configuration will be lost
    • ❌ You’ll need to manually reconfigure tracking via google_tag

    Upgrade Sequence

    1. ✅ Update directly to Drupal 11.1
    2. ✅ Migrate from google_analytics to google_tag module
    3. ✅ Verify analytics tracking is working
    4. ✅ Only then proceed to newer point releases (11.2+)

    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