Which version should I use?

Deciding which version to use

Depending on your Drupal core version:

Drupal Core version

Enterprise version

Drupal Core version

Enterprise version

8.7.x

Must use 8.x-2.x

8.8.x

Can use 8.x-2.x and 3.x.y. Should end up using 3.x.y sooner than later.

8.9.x

Can use 8.x-2.x and 3.x.y. Should end up using 3.x.y sooner than later.

9.x.y

Must use 3.x.y

10.x.y

Must use 4.1.x

History

In the Product Lifecycle of Drupal 8, we’ve been using 8.x-1.x and 8.x-2.x. At the end of it, as semantic versioning was available on Drupal.org, we adopted that and created 3.0.x, compatible with 8.8+ and 9+.

Releases 8.x-1.x

This was the first release branch of Drupal 8 support, kicked off quite before Drupal 8 was released. After some releases and lots of customers using Drupal 8 and Enterprise, we figured out that saving the Enterprise required metadata as part of the content was not the best idea to support the revisioning and workflow tools that were appearing.

Upgrades were provided, so after 8.x-2.x was released, 8.x-1.x was abandoned.

Releases 8.x-2.x

This was the second (and last) release branch of Drupal 8 support. With metadata stored outside of the content itself, we were able to accommodate and integrate better with revisioning and workflow tools that became popular and afterwards part of Drupal core itself.

Releases 3.x.y

With the imminent release of Drupal 9, and while we still needed to support Drupal 8.7.x but supporting both at the same time was possible but not easy, we created a new branch adopting semantic versioning for Drupal 9 support, while leaving 8.x-2.x active for 8.7.x.

3.x.y will be supporting the last LTS releases of Drupal 8 and Drupal 9.

Releases 4.1.x

With the release of Drupal 10, we have released 4.1.x version of the module to support Drupal 10. This version supports Drupal 9.5 and onwards.

3.x.y will be supporting the last LTS releases of Drupal 8 and Drupal 9.