Install

Works with Drupal: ^11.4 || ^12

Using Composer to manage Drupal site dependencies

Alternative installation files

Download tar.gz 502.63 KB
MD5: d3ee21d6379ba3891f14314d3b0feb78
SHA-1: e886de0aa3d8f5806f1204c13048131748750efa
SHA-256: d9784334285ff14300ae33d0b0da30fb1fae37cd03ed0e56474249dd240cadf8
Download zip 830.1 KB
MD5: 02d4eea1cfd191257ef89e4f7740c1ca
SHA-1: feb03b18aa849b08e9cd7c6aeb7fb680f4e72b89
SHA-256: c211201cee8456ad1db84b802f67f602f28a717dac6e3834449a74c542242f8c

Release notes

First release of the 4.x branch, for Drupal 11.4 and Drupal 12. It has the same features as 3.1, without the code 3.1 deprecated, and it includes the fix for SA-CONTRIB-2026-238.

Alpha releases are not covered by the Drupal security advisory policy. Sites that need that coverage should stay on 3.0.x.

Requirements

  • Drupal ^11.4 || ^12. Sites on Drupal 10 or on Drupal 11 before 11.4 should stay on 3.0.x or 3.1.x.

Upgrading from 3.x

All database updates of 3.x are kept, so a site can update from 3.0.x or 3.1.x directly. Before you update, make sure your custom code runs on 3.1.0-beta1 without deprecation warnings from Domain: everything 3.x marked as deprecated for removal in 4.0.0 is gone.

What changed from 3.1

  • Removed all code deprecated for removal in 4.0.0 (#3612485). This includes the old DomainNegotiator methods (use DomainResolver and DomainNegotiationContext, see #3583423 and #3575069), the DomainValidator methods replaced by constraints (#3574840), the procedural domain_source and domain_access functions replaced by their helper services, and the protected $domainStorage and $userStorage properties (use the domainStorage() and userStorage() methods, see #3612550).
  • Removed DomainSourceRouteMatcher and its route provider: since Drupal 11.4, core gives the path processor the route (#3623227).
  • Removed Drupal\domain\Form\DomainDeleteForm (#3615914).
  • Plugins use PHP attributes only: the remaining plugin annotations are gone (#3541558), and the deprecated uri_callback entity type property is replaced (#3613276).
  • Drupal 12 compatibility (#3612547, #3616749, #3616783, #3624244).
  • Every bug fix released in 3.1.0-beta1 is also in this release.

Contributors (2)

mably, pfrenssen

Full list of changes: 4.x commit history.

Created by: mably
Created on: 21 Oct 2026 at 18:06 UTC
Last updated: 21 Oct 2026 at 18:06 UTC
Bug fixes
New features

Other releases