Drupal is a registered trademark of Dries Buytaert

form_messages

4 sites Security covered
View on drupal.org

Form Messages is a simple module that introduces a new form element type:

$form['warnings'] = [
  '#type' => 'form_messages',
  '#message_type' => 'warning',
  '#messages' => [
    t('First warning message.'),
    t('Second warning message.'),
  ],
];

Features

  • Provides a new form element: #type = form_messages.
  • Supports status, warning, and error message types.
  • Allows single or multiple messages inline within a form.
  • Uses Drupal’s core message theming (status_messages), so styling is consistent with system messages.
  • Useful for inline guidance, warnings, or validation notes inside custom forms.

Example

$form['warnings'] = [
  '#type' => 'form_messages',
  '#message_type' => 'warning',
  '#messages' => [
    t('First warning message.'),
    t('Second warning message.'),
  ],
];

$form['info'] = [
  '#type' => 'form_messages',
  '#message_type' => 'status',
  '#messages' => [
    t('Your profile is 80% complete.'),
  ],
];

When to use this module

  • You need inline messages inside forms (instead of global messages).
  • You want to show form-specific messages (guidance, notices, validation tips).
  • You need multiple messages in one element, styled like Drupal’s system messages.

Why use this module?

  • Core’s status_messages element only displays messages added to Drupal’s global messenger service.
  • This module provides a flexible alternative, letting developers place form-specific messages directly in the form definition, without altering global messages.

Activity

Total releases
1
First release
Sep 2025
Latest release
5 months ago
Release cadence
Stability
100% stable

Releases

Version Type Release date
1.0.0 Stable Sep 20, 2025