Install

Works with Drupal: ^11

Using dev releases is not recommended, except for testing.

Using Composer to manage Drupal site dependencies

Alternative installation files

Download tar.gz 17.09 KB
MD5: 4140a7f6c061f989a1a458f5cb2b11e7
SHA-1: 3869a7cb27836def2f40277c4da6e948f969cf4d
SHA-256: 5d78e9865555c24d1be74eed2e75617d2a469e2d8accc20bfe7054534d95b64a
Download zip 27.32 KB
MD5: e488702212bddb31a177fa78093fc7eb
SHA-1: 757538c352e0a7cb8398ed5d48bfdb123f2a55d3
SHA-256: 0f8c43c1bace8cde44367f035a90d9cf2fc1f768ef7669e51574dce1724bf8f7

Release notes

First pre-release of the 3.x branch. Significant architectural rework
under issue #3591474.

WHAT'S NEW

- New FieldFormAlterer plugin type: per-field-type rewriting logic
lives in dedicated, attribute-discoverable plugin classes
(Plugin/FieldFormAlterer/*). Other modules can contribute their own.
- Plugins declare weight (execution order) and exclusive (whether
they terminate the chain on match — lowest weight wins among matches).
- Four built-in plugins: entity_reference, color_field, composite
("||"-separated values), simple (catch-all).
- Field description (help text) can now be rewritten on widgets, in
addition to the label — including composite "||" support.
- New kernel test suite covering weight/exclusive semantics and
description handling.

BREAKING CHANGES

- Drupal 11+ only. Drupal 9 and 10 are no longer supported on this
branch; use 2.x for those.
- All _entity_form_field_label_* procedural helpers have been removed
in favour of the plugin system. If you previously extended via those
helpers, see the README for the new extension point.

CONFIGURATION COMPATIBILITY

The third-party settings keys (rewrite_label, new_label) and the
existing config schema are unchanged. Form/view display entities
upgraded from 2.x keep working without intervention. The new keys
(rewrite_description, new_description) are optional.

UPGRADING FROM 2.x

1. Bump core to ^11 if you haven't already.
2. Replace dev-2.x / ~2.0 in your composer constraint with ^3.0@alpha.
3. Run `drush updb` (no DB updates are required at this time but it's
good practice).
4. If you had custom code calling _entity_form_field_label_* functions,
port it to a FieldFormAlterer plugin (see the README example).

KNOWN LIMITATIONS

- API may still change before the stable 3.0.0 release based on
community feedback. Pin to an exact alpha if you ship to production.
- Description rewriting applies to widgets only (form display); view
displays already render labels but not field help text.

Reviews welcome on issue #3591474.

Created by: nikita_tt
Created on: 22 May 2026 at 08:28 UTC
Last updated: 22 May 2026 at 08:29 UTC

Other releases