apply_filters( ‘login_message’, string $message )

Filters the message to display above the login form.

Parameters

$messagestring
Login message text.

More Information

The “login_message” filter is used to filter the message displayed on the WordPress login page above the login form. This filter can return HTML markup.

Source

$message = apply_filters( 'login_message', $message );

Changelog

VersionDescription
2.1.0Introduced.

User Contributed Notes

  1. Skip to note 7 content

    Add additional message for wp-login.php

    add_filter( 'login_message', 'wpdocs_sr_custom_login_message' );
    function wpdocs_sr_custom_login_message( $message ) {
        $action = isset( $_REQUEST['action'] ) ? $_REQUEST['action'] : '';
        $errors = new WP_Error();
    
        if ( isset( $_GET['key'] ) ) {
            $action = 'resetpass';
        }
    
        if ( isset( $_GET['checkemail'] ) ) {
            $action = 'checkemail';
        }
    
        switch ( $action ):
            case 'register':
                $message .= '<p class="message">' . __( 'Show message before register form.', 'text_domain' ) . '</p>';
                break;
            case 'checkemail':
                $message .= '<p class="message">' . __( 'Show message before after registration complete message.', 'text_domain' ) . '</p>';
                break;
            case 'lostpassword':
                $message .= '<p class="message">' . __( 'Show message before lost password form.', 'text_domain' ) . '</p>';
                break;
            default:
                // this message will show in login screen, before the login form.
                $message .= '<p class="message">' . __( 'Show message before login form.', 'text_domain' ) . '</p>';
                break;
        endswitch;
    
        return $message;
    }
  2. Skip to note 11 content

    Expanding upon Razon Komar Pal‘s code snippet.

    I found that there are a few other instances that you might wish to show a specific message or not show any additional messages if the provided one is great.

    add_filter( 'login_message', function ( $message ) {
        $action = isset( $_REQUEST['action'] ) ? $_REQUEST['action'] : '';
    
        if ( isset( $_GET['key'] ) ) {
            $action = 'resetpass';
        }
    
        if ( isset( $_GET['checkemail'] ) ) {
            $action = 'checkemail';
        }
    
        if ( isset( $_GET['interim-login'] ) ) {
            $action = 'interim-login';
        }
    
        switch ( $action ) {
            case 'register':
                // $message .= __( 'Show message before register form.', 'text_domain' );
                break;
            case 'checkemail':
                // $message .= __( 'Show message before after registration complete message.', 'text_domain' );
                break;
            case 'lostpassword':
                // $message .= __( 'Show message before lost password form.', 'text_domain' );
                break;
            case 'rp':
                // $message .= __( 'Show message before reset password form.', 'text_domain' );
                break;
            case 'resetpass':
                // $message .= __( 'Show message after reset password form.', 'text_domain' );
                break;
            case 'interim-login':
                // $message .= __( 'Show message before interim login form.', 'text_domain' );
                break;
            default:
                // $message .= __( 'Show message before login form.', 'text_domain' );
                break;
        }
    
        return $message;
    } );

You must log in before being able to contribute a note or feedback.