This is a beta release for the next minor (feature) release of Drupal 9. Betas are good testing targets for developers and site builders who are comfortable reporting (and where possible, fixing) their own bugs. Beta releases are not recommended for non-technical users, nor for production websites. More information on beta releases.
This minor release provides new improvements and functionality without breaking backward compatibility (BC) for public APIs. Note that there may be changes in internal APIs and experimental modules that require updates to contributed and custom modules and themes per Drupal core's backwards compatibility and experimental module policies.
Drupal 9.2.x contains new features, and should be the target for new site development. Drupal 8.9.x will continue to have security support until November 2021. Drupal 9.1.x will continue to have security support until December 2021. Security support for 9.0.x ends with the release of 9.2.0 on June 16.
Regardless of which version you choose now, features will only be added to Drupal 9 minor releases, so plan to adopt Drupal 9 this year so that you can easily update to Drupal 9.2 and later.
Beta testing program
The Drupal Association and the Drupal core maintainers are partnering with agencies and site owners in an official beta testing program for Drupal core minor releases. The program aims to identify and minimize regressions in minor releases. Participating in the program is a way to contribute to the Drupal project and will be credited accordingly.
Important update information
Updating from Drupal 8
For information on updating from Drupal 8 to Drupal 9, see Upgrading a Drupal 8 site to Drupal 9.
Sites on 8.7 or earlier must update to either 8.8 or 8.9 before updating to Drupal 9 as all Drupal 8 update functions from before Drupal 8.8.0-rc1 were removed from Drupal 9. We recommend updating to 8.9.x, as well as updating all contributed modules, before updating to any Drupal 9 release.
Note: The migration paths from Drupal 6 and Drupal 7 to Drupal 9 will remain supported throughout Drupal 9's release cycle.
Upgrading from Drupal 7
Drupal 7 users can continue to migrate to Drupal 8.9, or 9.2 directly. The upgrade path for multilingual sites is stable in both Drupal 8 and 9.
Important changes since Drupal 9.2.0-alpha1
The tour module previously depended on jQuery Joyride. Joyride is now replaced with Shepherd.
The core/jquery.joyride is now deprecated and core/shepherd is added. Tour config has changed, it no longer uses attributes with a data-id or data-class to indicate a target element for the tour. The selector property is used instead.
A BC layer is provided so that existing tours will still function, and any themes which use Stable or Stable9 as a base will have consistent markup for the Tour so that no theming changes should be necessary.
Dependency updates
The following PHP dependencies have been updated:
+-------------------------------+---------+---------+
| Production Changes | From | To |
+-------------------------------+---------+---------+
| composer/installers | v1.10.0 | v1.11.0 |
| doctrine/annotations | 1.12.1 | 1.13.1 |
| guzzlehttp/psr7 | 1.8.1 | 1.8.2 |
| laminas/laminas-diactoros | 2.5.0 | 2.5.1 |
| laminas/laminas-feed | 2.14.0 | 2.14.1 |
| psr/log | 1.1.3 | 1.1.4 |
| symfony/console | v4.4.21 | v4.4.23 |
| symfony/debug | v4.4.20 | v4.4.22 |
| symfony/dependency-injection | v4.4.21 | v4.4.23 |
| symfony/deprecation-contracts | v2.2.0 | v2.4.0 |
| symfony/error-handler | v4.4.21 | v4.4.23 |
| symfony/http-client-contracts | v2.3.1 | v2.4.0 |
| symfony/http-foundation | v4.4.20 | v4.4.23 |
| symfony/http-kernel | v4.4.21 | v4.4.23 |
| symfony/mime | v5.2.6 | v5.2.7 |
| symfony/process | v4.4.20 | v4.4.22 |
| symfony/routing | v4.4.20 | v4.4.22 |
| symfony/serializer | v4.4.20 | v4.4.22 |
| symfony/service-contracts | v2.2.0 | v2.4.0 |
| symfony/translation | v4.4.21 | v4.4.23 |
| symfony/translation-contracts | v2.3.0 | v2.4.0 |
| symfony/validator | v4.4.21 | v4.4.22 |
| symfony/var-dumper | v5.2.6 | v5.2.8 |
| symfony/yaml | v4.4.21 | v4.4.22 |
| twig/twig | v2.14.4 | v2.14.6 |
| psr/cache | NEW | 1.0.1 |
+-------------------------------+---------+---------+
+---------------------------+---------+---------+
| Dev Changes | From | To |
+---------------------------+---------+---------+
| drupal/coder | 8.3.12 | 8.3.13 |
| squizlabs/php_codesniffer | 3.5.8 | 3.6.0 |
| symfony/browser-kit | v4.4.20 | v4.4.22 |
| symfony/css-selector | v4.4.20 | v4.4.22 |
| symfony/filesystem | v4.4.21 | v4.4.22 |
| symfony/finder | v4.4.20 | v4.4.23 |
| symfony/lock | v4.4.21 | v4.4.23 |
| symfony/phpunit-bridge | v5.2.6 | v5.2.8 |
+---------------------------+---------+---------+
The projects psr/cache is added as a requirement dependency for doctrine/annotations.
CKEditor has been updated from 4.15.1 to 4.16.0, which includes numerous bugfixes and improvements.
The Sortable library has been updated to Sortable to 1.13.0
All changes since 9.2.0-alpha1:
- #3131281 by mondrake, rahulrasgon, longwave, ridhimaabrol24, naresh_bavaskar, jungle, daffie: [May 17th 2021] Replace assertEqual() with assertEquals()
- #3210443 by mherchel, bnjmnm, andy-blum, guilhermevp, Gauravmahlawat, Rinku Jacob 13: Olivero: Focus after submenu close via ESC key
- #3144854 by Spokje, bnjmnm, mherchel, zrpnr, komalk, Kristen Pol: Remove stylelint-no-browser-hacks
- #3051766 by bnjmnm, alexpott, Oleksiy, finnsky, zrpnr, jungle, Wim Leers, vacho, anmolgoyal74, lauriii, tim.plunkett, rachel_norfolk, andypost, catch, Gábor Hojtsy, nod_, fubarhouse: Deprecate and replace jQuery Joyride (for tours)
- #3214412 by bnjmnm, tedbow: Build + prettier not run after yarn dependency update 3210633
- #3126747 by phenaproxima, tim.plunkett, TR, Spokje: ContextDefinition::create() can no longer be used with an entitytype-specific datatype (like entity:user)
- #3207968 by quietone, longwave, Spokje: Replace @codingStandards comments with phpcs: comments
- #3211838 by mondrake, longwave: Convert assertions involving use of xpath on spans to WebAssert
- #3214308 by longwave, alexpott: Merge class_aliases.php into bootstrap.inc
- #3210633 by Spokje, bnjmnm, longwave, zrpnr: Update JavaScript dependencies for Drupal 9.2
- #3210632 by Spokje, longwave, daffie: Update dependencies for Drupal 9.2
- #3190815 by Wim Leers, quietone, NickDickinsonWilde, benjifisher, mikelutz, larowlan: Source count caching broken: impossible to enable source count caching for SqlBase-based source plugins (plus, unneeded cache I/O)
- #2969190 by manish.upadhyay, ranjith_kumar_k_u, Neslee Canil Pinto, mtodor, joachim: Change ModuleInstallerInterface::uninstall() method doc comment that ModuleUninstallValidatorException can be thrown
- #3214234 by alexpott: Add core/class_aliases.php
- #3209618 by catch, longwave, Neslee Canil Pinto, daffie, andypost, Gábor Hojtsy: [Symfony 6] Symfony\Component\HttpKernelent\KernelEvent::isMasterRequest() is deprecated, use isMainRequest() instead
- #3184527 by webflo: Reduce cache variations in locale cache
- #3213022 by andypost, jhodgdon: When generating link to non-existent help topic, put topic ID in fallback text
- #3209628 by longwave, rachel_norfolk, antiorario, phenaproxima, rootwork, larowlan, neclimdul, Maeglin: Add Permissions-Policy header to block Google FLoC
- #3176361 by alexpott, naresh_bavaskar, longwave: Remove semi-colon from javascript test conditions
- #3107130 by PCate, kishor_kolekar, ravi.shankar, Vidushi Mehta, rajneeshb, Kristen Pol, thalles, quietone, alexpott: Responsive image field formatter list should be sorted by label, not machine name
- #3123070 by Spokje, msuthars, quietone, longwave, jungle: Fix 'PSR2.Classes.PropertyDeclaration.Underscore' coding standard
- #2909369 by Spokje, alexpott, longwave, mfernea: Fix 'Drupal.Commenting.VariableComment.WrongStyle' coding standard
- #3208000 by Gauravmahlawat, mherchel: remove toolbar.html.twig template as #3174422 is fixed
- #2742997 by andypost, wizonesolutions, erozqba, naveenvalecha, johanv, MerryHamster, tvb, vacho, Eyal Shalev, daffie, mmrares, alexpott, larowlan: Convert CommentActionsTest to kernel test
- #3193189 by quietone, jibran: Get only translations for localized vocabularies d6/TermLocalizedTranslation.php
- #3132778 by kim.pepper, quietone, jungle, daffie: Replace usages of assertions with strstr with assertStringContainsString()/assertStringNotContainsString()
- #3207405 by Nikhil Banait, Gauravmahlawat, Abhijith S: Add 'Reset' button on Custom block library page
- #3191061 by jcisio, quietone: Remove todo in class Drupal\Core\Routing\RequestContext
- #3212005 by guilhermevp, tedbow, phenaproxima: Add @throws docs to factory methods in \Drupal\update\ModuleVersion
- #3213638 by bpstr: Fix incorrect Migration plugin description
- #3025727 by Krzysztof Domański, Matroskeen, alexpott: Using a data provider with array keys instead of comments in PhpTransliterationTest
- #3190820 by pavnish, WalkingDexter, ayushmishra206, durgeshs, daffie: Error: Call to a member function getTotalCount() on bool in statistics_tokens()
- #3210372 by pfrenssen, claudiu.cristea: Fatal error when passing non-existing ID to entity parameter converter
- #3210913 by quietone, Wim Leers, paulocs: DbDumpCommand fails when data type is not a mapped Drupal schema field name
- #3211601 by bnjmnm, nod_, zrpnr, lauriii: Update jQuery to version 3.6.0
- #3212547 by Spokje, quietone, alexpott, longwave: cspell Dictionaries changed, checking all files
- #3163487 by sudiptadas19, IT-Cru, raman.b, idebr, dawehner: Breadcrumb: $title could be an array, but Link() requires a string
- #3210888 by longwave: Undefined static method Drupal\Core\Database\Connection::serialize()
- #2868258 by joegraduate, Lendude, Jons, dawehner, alexpott, larowlan: Missing View not helpfully reported in preRenderViewElement()
- #3041885 by tedbow, beautifulmind, dww, ayushmishra206, phenaproxima, webchick, xjm, AaronMcHale, larowlan, benjifisher, heddn, catch, jhodgdon, longwave, mglaman, alexpott, mxr576, effulgentsia: Display relevant Security Advisories data for Drupal
- #588438 by dww: FormTest::testRequiredFields() fails to drupal_render() elements of #type 'radios'
- #3211936 by alexpott, daffie: Race condition when generating sub directories for image styles
- #2974128 by Majdi, quietone: Missing parameter in process plugin DefaultValue example
- #3211599 by Spokje, Wim Leers, lauriii, zrpnr, cilefen: Update CKEditor to version 4.16.0
- #3212704 by Gauravmahlawat, mherchel: Olivero: content below region 33/33/33 layout broken in IE11
- #3191649 by mherchel, bnjmnm: Update Sortable to 1.13.0
- #2608750 by phenaproxima, shriaas2898, KapilV, mohit_aghera, RenatoG, akhoury, guilhermevp, praveenmoses61, sulfikar_s, Abhijith S, larowlan, pameeela, Sid_omp: Exception when creating an entity reference field targeting an entity type without an ID
- Revert "Issue #2608750 by phenaproxima, shriaas2898, KapilV, mohit_aghera, RenatoG, akhoury, guilhermevp, praveenmoses61, sulfikar_s, Abhijith S, larowlan, pameeela, Sid_omp: Exception when creating an entity reference field targeting an entity type without an ID"
- #3145563 by Charlie ChX Negyesi, NigelCunningham, alexpott, joachim, longwave, catch, tyler36: Route serialization incompatibilities between PHP 7.4 and 7.3 (9.x only)
- #2938803 by David_Rothstein, spitzialist, vsujeetkumar, yepa, harsha012, ranjith_kumar_k_u, markconroy, ckrina, Rinku Jacob 13, Gauravmahlawat, longwave, Gábor Hojtsy: Remove the warning about the Umami profile on the install screen
- #3212998 by mherchel, Gauravmahlawat: Olivero: Normalize JavaScript selectors in scripts.es6.js
- #3212034 by longwave, quietone: Account emails are missing newlines due to malformed YAML
- #3207456 by Spokje, longwave, alexpott: Drupal 9 is dependent on symfony/mime directly
- #3211480 by longwave, daffie: \Drupal\Tests\system\Functional\Common\UrlTest can be a kernel test
- #3211474 by longwave, daffie: CKEditorLoadingTest::testExternalStylesheets() should be a kernel test
- #3212354 by guilhermevp, Chi: AggregatorFeedBlock::build must always return array
- #3212539 by n4r3n, Wim Leers: Map all Link module's fieldformatters from D7 to D8/D9
- #3190120 by mherchel, KapilV, pragati_kanade, djsagar, andy-blum, bnjmnm, andrewmacpherson, Abhijith S, KarinG, Gauravmahlawat, benjifisher, AndyF, katannshaw: Olivero: Focused level-2 nav items should always be in viewport during keyboard navigation
- #3191725 by mherchel, kostyashupenko, Kristen Pol, andy-blum, lauriii, proeung, Gauravmahlawat, jwitkowski79, katannshaw: Ensure that tabledrag user interface is usable within Olivero
- #3211897 by mherchel, Gauravmahlawat: Olivero: On mobile width, submenu can unintendedly close when user attempts to scroll on mobile
- #3153265 by kiran.kadam911, hinal05, komalk, mherchel, kishor_kolekar, ambuj_gupta, Abhijith S, chetanbharambe, andrewmacpherson: Olivero: Skip link focus should not create layout shift
- #3212281 by Sakthivel M, tushar_sachdeva, chetanbharambe: Paragraph format dropdown in body field have extra left spacing
- #3212521 by Spokje, longwave: cspell dislikes identifer in core/modules/views/src/Plugin/views/filter/FilterPluginBase.php and will fail any patch touching that file