function theme_status_messages

Returns HTML for status and/or error messages, grouped by type.

An invisible heading identifies the messages for assistive technology. Sighted users see a colored box. See for info.


$variables: An associative array containing:

  • display: (optional) Set to 'status' or 'error' to display only messages of that type.

Related topics

5 theme calls to theme_status_messages()
ajax_prepare_response in drupal/includes/
Converts the return value of a page callback into an Ajax commands array.
file_ajax_upload in drupal/modules/file/file.module
Menu callback; Shared Ajax callback for file uploads and deletions.
hook_ajax_render_alter in drupal/modules/system/system.api.php
Alter the commands that are sent to the user through the Ajax framework.
template_preprocess_maintenance_page in drupal/includes/
Process variables for maintenance-page.tpl.php.
template_process_page in drupal/includes/
Process variables for page.tpl.php


drupal/includes/, line 1673
The theme system, which controls the output of Drupal.


function theme_status_messages($variables) {
  $display = $variables['display'];
  $output = '';
  $status_heading = array(
    'status' => t('Status message'),
    'error' => t('Error message'),
    'warning' => t('Warning message'),
  foreach (drupal_get_messages($display) as $type => $messages) {
    $output .= "<div class=\"messages {$type}\">\n";
    if (!empty($status_heading[$type])) {
      $output .= '<h2 class="element-invisible">' . $status_heading[$type] . "</h2>\n";
    if (count($messages) > 1) {
      $output .= " <ul>\n";
      foreach ($messages as $message) {
        $output .= '  <li>' . $message . "</li>\n";
      $output .= " </ul>\n";
    else {
      $output .= reset($messages);
    $output .= "</div>\n";
  return $output;