Using WordPress wp_login_form to create custom login forms

The WordPress wp_login_form function is a built-in function that allows developers to easily display a login form on any page of their WordPress website. This function can be useful for creating custom login pages, integrating login forms into custom templates, or adding a login form to a widget area.

Using the wp_login_form function can save developers time and effort by providing a standardized way to display a login form without having to manually code the HTML and PHP for the form. This can help maintain consistency across the website and ensure that the login form is properly integrated with WordPress’s authentication system.

Parameters Accepted by wp_login_form Function

The wp_login_form function accepts the following parameters:

  • $args (array, optional. Default value: array()): Array of options to control the form output

Return Value of wp_login_form Function

The wp_login_form function returns either void or a string. It returns void if the ‘echo’ argument is true, and it returns the login form HTML if ‘echo’ is false.


How to display a simple login form using wp_login_form

 echo wp_login_form();

This code snippet simply displays a basic login form using the wp_login_form function. It doesn’t have any additional parameters, so it will use the default settings for the form.

How to customize the login form using wp_login_form

 $args = array(
 'echo' => true,
 'redirect' => home_url(),
 'form_id' => 'loginform',
 'label_username' => 'Username',
 'label_password' => 'Password',
 'label_remember' => 'Remember Me',
 'label_log_in' => 'Log In',
 'id_username' => 'user_login',
 'id_password' => 'user_pass',
 'id_remember' => 'rememberme',
 'id_submit' => 'wp-submit',
 'remember' => true,
 'value_username' => '',
 'value_remember' => false
 echo wp_login_form($args);

This code snippet customizes the login form using the wp_login_form function. It uses an array of arguments to modify various aspects of the form, such as the labels, IDs, and redirect URL.

How to conditionally display the login form using wp_login_form

 if ( !is_user_logged_in() ) {
 echo wp_login_form();
 } else {
 echo 'You are already logged in.';

This code snippet uses the wp_login_form function within a conditional statement to only display the login form if the user is not already logged in. If the user is logged in, it will display a message saying “You are already logged in.”


In conclusion, the wp_login_form function is an useful component for customizing the login form on WordPress websites. With its flexibility and ease of use, developers can easily create and modify login forms to fit their specific needs. By understanding the parameters and options available, developers can take full advantage of this function to enhance the user experience and security of their websites. Overall, the wp_login_form function is a valuable resource for WordPress developers looking to create a seamless and secure login process for their users.

Related WordPress Functions