WordPress Troubleshooting: Unable To Log Into WordPress Administration

Learn what to do if you are unable to log into your WordPress Administration area.

WordPress Troubleshooting: Unable To Log Into WordPress Administration AreaThis tutorial is part of our WordPress Management tutorial series. In this tutorial, we show you what to do if you are unable to log into your WordPress Administration area.

To view all of our WordPress troubleshooting tutorials, go here:

WordPress Troubleshooting: Unable To Log Into WordPress Administration Area

Sometimes errors can cause WordPress login problems, or make your WordPress dashboard unavailable, preventing you from accessing plugins, themes and other important information on your site.

In this section, you will learn what to do if you are unable to log in or regain access to your WordPress Administration area.

Checklist

Troubleshooting Checklist

Have you established that the problem / issue is not related to:

If none of the above are possible reasons, try one of the solutions listed below.

Unable To Log Into WordPress Administration Area? Try These Methods

Can’t log into your WordPress Administration area? Try the methods below:

Method 1: Edit Users Table

Info

For this tutorial, you will need to have access to a cPanel hosting account and phpMyAdmin.

Log into your cPanel administration area …

WordPress Troubleshooting

Click on phpMyAdmin in the ‘Databases’ section of your administration panel …

WordPress Troubleshooting

This takes you to the main ‘phpMyAdmin’ section …

WordPress Troubleshooting

Click on the MySQL database associated with your WordPress site …

WordPress Troubleshooting

Most default WordPress installations automatically assign the suffix “wrdp1” to the database.

Note: Several WordPress installations are shown above – make sure to choose the correct database for the site you are trying to log into. On multiple WordPress installations, suffixes “wrdp2”, “wrdp3”, etc are assigned. In the example above, the database name is “wptod1”, and we are going to use the “wrdp3” installation for this tutorial.

Click on the database name to load the MySQL data tables structure into the main window of your phpMyAdmin panel …

WordPress Troubleshooting

Click on the wp users table in the left menu (default is wp_users, or yourprefix_users if you defined a different table prefix), or ‘wp_users’ in the main window …

WordPress Troubleshooting

Make sure that you are in the ‘Browse’ section, and click on the ‘Edit’ link in the database row of the admin user …

WordPress Troubleshooting

Delete whatever is currently in the password field (‘user_pass’) …

WordPress Troubleshooting

Enter a new password …

WordPress Troubleshooting

Note: Make sure to enter a strong password into the ‘user_pass’ field.

To learn more about creating strong passwords, see the tutorial below:

From the ‘user_pass’ row’s Function drop-down list, choose MD5

WordPress Troubleshooting

Click ‘Go’ to save the new information in the database …

WordPress Troubleshooting

Your new password will be made secure in the database via the MD5 data encryption method …

WordPress Troubleshooting

Log into WordPress using your admin username and the new password you have just created …

WordPress Login Screen

Your WordPress admin access should now be restored …

WordPress Troubleshooting

Congratulations! Now you know how to regain access to your WordPress Administration area by editing your Database’s ‘WP Users’ table.

Method 2 – Edit ‘functions.php’ File

Use the method described below if you have changed the URL of your WordPress installation in the General Settings‘ section, and find yourself unable to log back in.

Disclaimer

In order to complete this tutorial, you will need to edit a WordPress installation file called ‘functions.php’. We provide a step-by-step tutorial below that you can follow and a downloadable template. If you don’t feel comfortable editing files, however, then seek help from professionals.

Changed General Settings URL And Can’t Log Back In

On single WordPress installations, the Settings > General screen contains two fields where URLs are entered:

  • WordPress address (URL) – also known as the “Home” URL setting. The “Home” setting is the address you want people to type in their browser to reach your WordPress site.
  • Site address (URL). also known as the “Site URL” setting. The “Site URL” setting is the address where your WordPress core files reside.

General Settings

The above fields are important settings, as they control where WordPress thinks your site is located. These settings control the display of the URL in the admin section of your page as well as the front end, and are used throughout the WordPress code.

Note: Both settings should include the http:// part and should not have a slash “/” at the end.

There may be instances where the URLs in these fields may need to get changed for some reason, or get accidentally changed (i.e. mistakes, typos, etc.), and you discover that your site no longer works properly, or it is being redirected to another URL, leaving you unable to log into your WordPress admin area.

If you have changed the URL values incorrectly, and you have access to the site via FTP, then follow the method below to quickly get your site back up and running:

Edit functions.php

Open your FTP application and connect to your site, then open the ‘public_html’ folder …

Troubleshooting WordPress

Locate the ‘functions.php’ file inside your active theme folder …

Troubleshooting WordPress

Transfer a copy of the file to your hard drive. We recommend making two copies: one for editing (see below), and one to keep as an original backup in case something goes wrong and you need to reinstall the original file …

Troubleshooting WordPress

You will need to edit the ‘functions.php’ file to make the necessary changes that will give you access again to your WordPress Admin area.

Open the ‘functions.php’ file using a simple text editor (e.g. notepad) …

Troubleshooting WordPress

Note: to view a .php file in notepad, make sure to select ‘All Files’ from the file type drop-down menu, not the default (i.e. ‘Text Files (.txt)’) …

Add these two lines to the file, immediately after the initial “<?php” line …

Troubleshooting WordPress

Make sure to replace “yoursite.com” with your own site’s URL.

Note: If your site is installed in a sub-directory (e.g. ‘http://yoursite.com/blog’), then make sure to use the correct URL.

Your file should look like the example shown below …

Troubleshooting WordPress

Save the file and re-upload it back to your site, replacing the original ‘functions.php’ file in the same location.

Visit your login page. You may need to try a couple of times before the site comes back up.

Log into WordPress using your admin username and password …

WordPress Login Screen

Your WordPress Admin access should now be restored …

WordPress Troubleshooting

Once your site has been restored and is up and running again, repeat the above steps, then open the ‘functions.php’ file, remove the two lines you previously added, resave the file and re-upload it to your site without those lines.

Tip

Method 3: If No ‘functions.php’ File Exists

If there is no ‘functions.php’ file in your WordPress theme, follow the steps below to create one, or just download the template ‘functions.php’ file provided below.

How To Create A functions.php file

Create a new blank text file using notepad …

Troubleshooting WordPress

Add the code below to the file, replacing “yoursite.com” with the URL of your site …

Troubleshooting WordPress

Save the file as ‘functions.php’ (remember to choose ‘Save as type: All Files’ before saving) …

Troubleshooting WordPress

Upload the new file to your theme directory (‘/public_html/wp-content/themes/themename‘), then visit your login page and try to login.

If login is successful, return to your FTP screen and delete the ‘functions.php’ file from your themes folder, as this file did not previously exist for that theme …

Troubleshooting WordPress

Congratulations! Now you know how to regain access to your WordPress Administration area by editing your theme’s ‘functions.php’ file.

Tip

If Editing The functions.php File Doesn’t Work

If editing your functions.php file does not work, then refer to the ‘How To Manually Override Your WordPress Login Details’ section in the tutorial below:

If You Still Cannot Log Into Your WordPress Administration

The WordPress Codex provides a list of possible reasons why you may have been locked out of your WP Admin area with solutions that will require you to edit some of your installation files.

This includes the following:

  • WordPress MultiSite Network error
  • Corrupted wp-login.php file (New Login File) – file may have been corrupted or uploaded incorrectly.
  • Site URL Redirecting – In certain cases your WordPress address URI may have been reset. Or, you may have changed your WordPress address URI and can still access the login page, but cannot login or access the database.
  • Issues with subdomains or subdirectories
  • Issues with secure browsing (Secure HTTPS)
  • Issues with your URL Options – In some situations, your site can be seen from inside your domain, but not outside.

If you suspect that any of the above reasons may be the cause of your difficulties logging into WordPress, then visit the WordPress help page below for possible solutions:

Additionally, check the ‘Tutorials’ section below or see the additional resources links in this tutorial:

Next Section:

Now that you know about different methods to regain access to your WordPress admin area, click on the link below to view the next section of our WordPress Troubleshooting Guide.

To learn what to do if you are experiencing WordPress errors related to plugins, see the tutorial below:

WordPress Troubleshooting: Unable To Log Into WordPress Administration Area

(Source: Pixabay)

***

"I have used the tutorials to teach all of my clients and it has probably never been so easy for everyone to learn WordPress ... Now I don't need to buy all these very expensive video courses that often don't deliver what they promise." - Stefan Wendt, Internet Marketing Success Group

***

Originally published as WordPress Troubleshooting: Unable To Log Into WordPress Administration.