Form Messages

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.