Important versions for upgrade path

YMCA Website Services development moves quickly and in this document, we flag important versions that should not be skipped while you upgrade your sites.

Determining your upgrade path

For example: If you are on YMCA Website Services 8.1.2 and want to upgrade to YMCA Website Services 8.2.8.5 you should make it in a couple of steps

  1. Upgrade 8.1.2 to 8.1.13.1
  2. Upgrade 8.1.13.1 to 8.2.2.1
  3. Upgrade 8.2.2.1 to 8.2.7.3
  4. Upgrade 8.2.7.3 …

These supplemental documents elaborate on a few specific cases:

Important versions

  • 8.1.13.1 - Optional, when you have a lot of customized code and 8.2.2.1 is failing in most places.

  • 8.2.2.1 - This is a very important step everyone should have. After this version, drush entup stops working. In this version, we finally migrated to the core media subsystem, and before going further it is important to upgrade media by upgrading your site to this version first.

  • 8.2.7.3 - This is a very stable Drupal 8 based YMCA Website Services with a bunch of contrib module updates. This is one of the last Drupal 8 based YMCA Website Services versions before the upgrade to Drupal 9 core. Also, in 8.2.7.0 and 8.2.7.1 we started to introduce multiple version constraints in composer.json to allow developers to choose between the minimum or latest dependency versions. This is for securing the upgrade path as well as adding flexibility for version selection if needed.

  • 9.2.8.0 - Drupal 9 version which must be used in the upgrade path before going to 9.2.8.1+. This version added 9.0-9.1 Drupal Core and disabled deprecated components.

  • 9.2.10.0 - Removed a bunch of unused modules from distribution.

  • 9.2.11.3 - Last Open Y Drupal core 9.3.* release

  • 9.2.11.4 - Technical release of YMCA Website Services ( no diff with 9.2.11.3 )

  • 9.2.13.0 - Pre Drupal 10 release, latest Drupal 9 release. Before going into Layout Builder era it is recommended to uninstall geysir, openy_inline_editing, quickedit, rdf modules.

  • 10.2.14 - Drupal 10|9 release, where you may follow the recommendations below:

    1. Upgrade to the latest Drupal 9 core (using version 10.2.14 of the distribution, released in June 2023).
    2. Upgrade all contrib modules and libraries to their latest Drupal 9-compatible versions (with composer update).
    3. Use drupal-rector, drupal-check, and PHPCS to prepare custom modules and themes for Drupal 10.
    4. Upgrade to Drupal 10 and run regression testing to search for hard-to-find bugs (update drupal/core-* projects in composer.json, then run compuser update).
    5. Upgrade all contrib modules on the Drupal 10 site to their latest versions (composer update).

  • 10.3.0.1 - Drupal 10|9 release, before New Demo Content and Initial Replacement Paragraphs to Blocks for Native Layout Builder Experience

  • 10.3.1 - Drupal 10|9 release, New Demo Content and Initial Replacement Paragraphs to Blocks for Native Layout Builder Experience. In this release we bumped a lot of dependencies to become up to date

  • 10.3.2 - Introduced recurring event support in the Event Content Type which requires an automated migration between date_range and smart_date fields. If possible, update to this version during the upgrade process.

  • 10.3.2.3 - Introduced before 10.1 and 10.2 Drupal core. Also upgraded openy_map. This version ensures we support removed modules pre 10.1 for contrib modules

  • 11.1.0.0 - First stable Drupal 11 release (November 18, 2025). Includes PHP 8.3+ requirement, jQuery Migrate for backward compatibility, Activity Finder 6.0.0, Memberships 3.1.0, and full Drupal 11 support. Production ready. See Drupal 11 Migration Guide and Full Changelog for details.

    ⚠️ Important Drupal Core Version Requirement: Before upgrading to YMCA Website Services 11.1.0.0 (Drupal 11), your site must be running Drupal core 10.3.x or higher. The YMCA Website Services distribution version number (e.g., 10.3.2.3) does not directly reflect the underlying Drupal core version. Verify your Drupal core version before attempting the upgrade to Drupal 11. For detailed prerequisites and upgrade instructions, see:

  • 11.1.0.2 - Required intermediate step before upgrading to 11.3.x. Ensures all pre-11.3 update hooks are executed.

  • 11.3.1.0 - Major Drupal 11.3 release. Drupal core upgraded from 11.1.9 to 11.3.3. Key changes:

    • Entity Browser replaced by Media Library - all media fields migrated from Entity Browser/DropzoneJS to core Media Library
    • Google Analytics module removed - replaced by Google Tag (google_tag). Sites must configure Google Tag after upgrade
    • GroupEx Pro deprecated - automatically uninstalled via drush updb
    • Media Directories replaced by Media Tags (media_directories removed)
    • Trash module enabled by default - provides soft-delete functionality for content
    • AVIF GD extension required - PHP must have GD compiled with AVIF support
    • History module removed from Drupal core
    • Removed modules: entity_browser, dropzonejs, google_analytics, media_directories, history, groupex_pro
    • 67% faster installation
    • PHP 8.4/8.5 stability fixes

    ⚠️ Upgrade path requirement: You must upgrade to 11.1.0.2 first before upgrading to 11.3.1.0. Do not skip directly from 11.1.0.0 to 11.3.x.

See Version Constraints practices for YMCA Website Services

Known issues

For Drupal 10 Sites (pre-11.0)

If you are not using Rose or Lily theme, you need to uninstall them before applying 10.5.0.0 If you are using Rose theme, you need to re-require Drupal/openy_rose before applying 10.5.0.0. If you are using Lily theme, you need to re-require Drupal/openy_lily before applying 10.5.0.0.

For Drupal 11 Upgrades

Important: Lily and Rose themes have been removed from Drupal 11 distributions. If you are upgrading to Drupal 11, you must migrate to the Carnation theme before upgrading. The Carnation theme is the only supported theme for Drupal 11+.

See the Drupal 11 Migration Guide for:

  • Prerequisites (PHP 8.3+, latest Drupal 10)
  • Known issues (jQuery 3.x compatibility)
  • Upgrade steps and troubleshooting

For 11.3.x Upgrades

  • AVIF support required: Ensure your PHP GD extension is compiled with AVIF support before upgrading to 11.3.1.0.
  • Entity Browser removal: All Entity Browser and DropzoneJS widgets are automatically migrated to Media Library. Review your custom media fields after upgrade.
  • Google Analytics replacement: The google_analytics module is removed. Configure google_tag module after upgrade to maintain tracking.
  • GroupEx Pro: Automatically uninstalled during drush updb. If your site uses GroupEx Pro integrations, plan for alternative solutions before upgrading.

If you are faced with an issue when composer installs an improper version of drupal/core for the chosen version of YMCA Website Services from the list above, please use this trick in order to downgrade:

composer require drupal/core-recommended:9.5.9

Run the above command where your docroot is. Use the current core version instead of 9.5.9.

Last modified March 6, 2026: Update documentation for YMCA Website Services 11.3.1.0 release (f2421122b)