The 22nd Open edX community release will be named Verawood. Consult the Open edX Release Schedule for details around when the release master branch will be cut and the actual release will occur.

Put stuff here that we have to remember when we start packaging up Verawood. Especially important is information that system installers or operators will need to know. Please include your name when you add an item, so that we can get back to you with questions.

Operational

The HELP_TOKENS_BOOKS setting has been updated to reference the official Open edX documentation. Similarly, the help_tokens.ini file, which is specified in the HELP_TOKENS_INI_FILE setting, was updated in both the LMS and CMS configurations to ensure the paths align with the official Open edX documentation.
- fix: fixing the documentation article links by DeimerM · Pull Request #37493 · openedx/edx-platform
- Note: This is a breaking change that many operators may want, but if you wish to retain the original values, you must provide overrides.

Deprecations and Removals

Deprecation: Custom edx-val storage settings in favor of Django STORAGES

Contributor: Muhammad Arslan Abdul Rauf

The edx-val application previously relied on a custom setting (VIDEO_IMAGE_SETTINGS, VIDEO_TRANSCRIPTS_SETTINGS, etc.) to determine storage backends. This behavior is now deprecated in favor of the standard Django 5.2+ STORAGES configuration. The key within the STORAGES config for a custom video transcript location is video_transcripts.

See fix: use configured STORAGE_KWARGS if available by marslanabdulrauf · Pull Request #593 · openedx/edx-val for the code change.

As of Verawood:

edx-val now correctly respects Django’s STORAGES dict, giving it precedence over legacy per-feature storage settings.
Custom edx-val storage settings will continue to function during the Verawood cycle but are officially deprecated and will be removed in a future release.
Operators should migrate their storage configuration to Django’s STORAGES format to ensure forward compatibility.

Required Action for Operators:

Update your environment configuration:

Define the required edx-val storages inside Django’s STORAGES dictionary (e.g., for transcripts, videos, and images).
Remove or stop relying on deprecated edx-val specific storage configuration variables.
Review any existing custom overrides in lms/envs/common.py or deployment-specific files to ensure compatibility.

Example minimal migration:

STORAGES:
  video_transcripts:
    BACKEND: storages.backends.s3boto3.S3Boto3Storage
    OPTIONS:
      bucket_name: your-transcript-bucket

  video_image:
    BACKEND: storages.backends.s3boto3.S3Boto3Storage
    OPTIONS:
      bucket_name: your-image-bucket

NOTE: Failure to migrate before the legacy settings are removed may result in incorrect storage backends being used

The SERVICE_VARIANT setting is no longer set from the environment. The setting will be set to 'cms' in cms/envs/common.py and to 'lms' in lms/envs/common.py regardless of any environment variable set (DEPR).
In the CMS, the settings ID_VERIFICATION_SUPPORT_LINK, PASSWORD_RESET_SUPPORT_LINK, ACTIVATION_EMAIL_SUPPORT_LINK, and LOGIN_ISSUE_SUPPORT_LINK are now set to the value of the SUPPORT_SITE_LINK setting. Previously they defaulted to '' (PR).
The setting USE_L10N was removed since it was removed in Django 5.0 (PR).

Default Changes for Verawood

Removal of Temporary SAML Toggle

The SAML feature toggle referenced here no longer exists. Any configuration setting this toggle has be removed (see fix: removal of temporary saml toggle by ktyagiapphelix2u · Pull Request #37651 · openedx/edx-platform).

Notes for Release Manager (not for release notes)

Verawood - Operator Release Notes

Operational

Deprecations and Removals

Default Changes for Verawood

Removal of Temporary SAML Toggle

Notes for Release Manager (not for release notes)