Problem/Motivation

At /admin/config/people/accounts, it is not documented anywhere in the UI that clearing the body field of any account email template will disable that email from being sent entirely. This is a useful feature, but it is invisible to administrators who may either accidentally suppress emails or never discover the capability exists.

Steps to reproduce

  1. Navigate to /admin/config/people/accounts.
  2. Scroll to the Emails section.
  3. Observe that no text exists to indicate what an empty body field does.

Proposed resolution

Add a #description to the $form['email'] vertical tabs container in AccountSettingsForm::buildForm() to inform administrators of this behavior:

$form['email'] = [
  '#type' => 'vertical_tabs',
  '#title' => $this->t('Emails'),
  '#description' => $this->t('Removing all text from the body of an email will disable that email from being sent.'),
];

Remaining tasks

  1. Review and agree on the wording of the hint text.
  2. Confirm the description renders correctly beneath the Emails heading in the UI.
  3. Review and commit.

User interface changes

A single line of descriptive text is added beneath the Emails vertical tabs heading on /admin/config/people/accounts. No other UI elements are added, removed, or changed.

Introduced terminology

None.

API changes

None.

Data model changes

None.

Release notes snippet

The account email settings page (/admin/config/people/accounts) now displays a note informing administrators that removing all text from an email body field will disable that email from being sent.

Issue fork drupal-3580795

Command icon Show commands

Start within a Git clone of the project using the version control instructions.

Or, if you do not have SSH keys set up on git.drupalcode.org:

Comments

chris matthews created an issue. See original summary.

chris matthews’s picture

StatusFileSize
new552 bytes

nicxvan’s picture

I think a screenshot would help and I bet the ux team will have some feedback.

I think it's a great idea!

chris matthews’s picture

Version: main » 11.3.x-dev
Issue tags: +Needs usability review
mtift’s picture

Status: Active » Reviewed & tested by the community

Code looks good to me. The message text makes sense.

rkoller’s picture

i think the MR needs to be against the main branch (currently equal to 12.x) and the changes get then be cherry picked against previous versions.

nicxvan’s picture

Version: 11.3.x-dev » main

Yes and we need a screenshot for interface changes

nicxvan’s picture

Status: Reviewed & tested by the community » Needs work
rkoller’s picture

and i can put the issue on the short list for the meetings on fridays. not 100% sure we will get to it already this friday cuz the issue we've discussed the last two weeks is not completely finished but this issue is rather brief so odds are high that we will be able to discuss it either already this friday or otherwise friday next week.

rkoller’s picture

StatusFileSize
new128.77 KB
new70.53 KB

Usability review

We discussed this issue for the first time at #3581812: Drupal Usability Meeting 2026-04-03. The link to the recording: https://youtu.be/LyBy7cDksSc?t=1400&si=Ixk35BW5CIYs_v1P . The attendees at the usability meeting were @nicxvan, @rkoller, @simohell, and @worldlinemine.

Our discussion was based on the latest state of MR15168. In general adding the information contained in the description is a good thing, we've only noticed a few noteworthy details:

Visually there is a disconnect between the description and the body field it refers to. Instead of being left aligned to the body field within the content area of the active vertical tab the description is left aligned to the vertical tabs itself - through that shift to the left underneath the block of vertical tabs it is not necessarily clear to what the description refers / belongs to or if the description is getting noticed at all. Plus, depending on the availability and height of the body field within the content area of the active vertical tab, there could also be a rather large gap between the last vertical tab and the description:

vertical tabs for the different emails in the account settings with welcome no approval required as the active tab in the default_admin theme

Or the description is shown in close proximity even when there is no enabled visible body field available for the active vertical tab.

vertical tabs for the different emails in the account settings with account cancled as the active tab in the default admin theme

So in case the user notices the description underneath and considers it relevant in the context of the vertical tabs and or body field it is a cognitively/visually demanding task switching the focus back and forth from the body field within the content area of the active vertical tab to the description underneath.

Programmatically, there is also no association of the description to the body field which poses a problem for screenreader users. No one explores the entire page thoroughly, so with the description after the block of vertical tabs, the description could go unnoticed without the programmatic association most likely.

Aside those points there is also one question in regard to multilingual sites. For a site with fro example two languages, what happens if there is a translation in one language but the site is missing a translation for the other language (no translation was added/created). Will the email still be sent but just in the other existing language or will no email be sent if the translation is missing? The group considered that question a relevant detail to decide which measure to recommend - some options that came to mind would be either a warning message or should the description be expanded to inform the user about the constraints in the context of multilingual sites?

There was a clear consensus in the group to move the description into the content area of the vertical tab and display it right underneath the body field, but only when the body field is enabled and visible. The description should also be programmatically associated with the body field by the aria-describedby attribute.

If you want more feedback from the usability team, a good way to reach out is in the #ux channel in Slack.

chris matthews’s picture

smustgrave’s picture

Status: Needs review » Reviewed & tested by the community

Based on the screenshots seems straight forward enoguh.