Blank WordPress Admin Panel

How To Fix A Blank WordPress Admin Panel

— A blank WordPress Admin Panel is one of the most confusing problems WordPress users may get to face. In this guide, learn what to do when your wp-admin is blank or not working —

A blank panel usually happens unexpectedly and may leave you biting your fingers trying to find out why a page that always gave you power to control your site, has suddenly decided to display nothing at all.

And in some cases, the left menu may be displayed, but that’s about it.

If you are currently dealing with a blank WordPress admin panel, this post will guide you through the steps you can take to resolve this issue.

Before going through the rest of the article, you may check this short video for some common reasons why your wp-admin is blank. But if you want a more detailed explanation, skip this and continue below.

What Causes a Blank WordPress Admin Panel?

Although it can take quite some effort to pinpoint the cause of a blank WordPress admin panel, it almost always means an error in your WordPress code. You can often trace this error to plugins or themes you recently installed. So if you made any very recent changes to your site, those are quite possibly the reason why your wp-admin is blank.

A blank WordPress admin panel could also be the result of other issues, such as running out of allocated memory, or problems with your webhost.

In this guide, we will start by going through the most common sources of this problem. After exhausting these options, you would likely already have resolved your issue. If not, then you can go on with the steps toward the end to troubleshoot your issue.

Common Issues And Their Solutions

  1. Problems in your webhost.

    Solution: Check if your host is having problems.

  1. Theme related errors.

    Solution: Disable Active Theme.

  1. Plugin related errors.

    Solution: Disable Plugins.

  1. An Empty line in your wp-config file.

    Solution: Remove empty lines and PHP closing tag (?>) from wp-config file.

  1. Running out of memory.

    Solution: Increase PHP Memory Limit.

  1. Database Issues.

    Solution:Repair Database.

  1. Code errors that can be seen by enabling Debug mode.

    Solution:Enable Debug Mode.

How To Fix A Blank WordPress Admin Panel

Check if your host is having problems

Problems from your host may often lead to a blank WordPress admin panel.

If, for example, you have 2 websites on the same host, and you are experiencing this problem across both websites, you can be almost certain it is your host.

You should first check with your host to see if they are having problems, or are getting similar complaints from other users. If that’s the case, you can choose to wait for the problem to be resolved, or better yet, upgrade to a managed, reliable, WordPress hosting service.

If you decide to switch, we recommend you use WP Engine managed hosting service. This service is robust and reliable and will help you avoid security issues, data loss, or other problems that could make wp-admin blank.


Disable Active Theme

In many cases, a blank WordPress admin panel results from code errors in your currently active theme. You can resolve this by disabling the theme.

However, since you cannot access your dashboard to do this, you have to disable your theme manually using FTP. Please follow the steps below:

First, access your WordPress files using FTP. You would need your cPanel login details to do this, and you may ask your host for these details if you do not have them.

After accessing your site, FileZilla will display your site files and folders on the bottom right. Locate the folder containing your WordPress blog and double click it. If your blog is in your main domain (e.g. blog link is www.domainname.com), this folder should be “public_html”. If it is in a subdomain (e.g. blog.domainname.com), then you should see a folder named after the subdomain.

Blank WordPress Admin Panel - public_html folder

Search for “wp-content” folder and double click to open it.

Blank WordPress Admin Panel - wp_content folder

Search for the “themes” folder and double click to open it.

Rename themes folder to find out why wp-admin stopped working

Next, search for the folder for your currently active theme. Right click on it, select Rename, and change the name of this folder to something like “foldername_disabled” so WordPress can no longer read it.

Rename active theme folder

Now try accessing your admin panel. If it displays correctly, then there was a problem with your theme. In that case, you may want to delete the theme and reinstall a freshly downloaded copy. If after this, the problem persists, you can contact your theme provider, or change to another theme.

Note: When you manually disable your current theme, your frontend will stop displaying. You would need to activate another theme from your dashboard to fix this issue.

Disable Plugins To Solve Blank WordPress Admin Panel

If wp-admin is still not working after disabling your active theme, your next step should be to disable all your plugins to see if a plugin is responsible. You also have to do this via FTP using the following steps:

First, access your files using FTP (FileZilla) and your cPanel details. Ask your host for your cPanel details if you do not have them.

When you are connected to your server, Filezilla will display your site folders on the bottom right. Locate the folder containing your WordPress blog and double click to open it. This folder is often named public_html.

WP-admin not working - public_html folder

Search for “wp-content” folder and double click to open it.

wp-admin not working - wp_content folder

Next, locate the plugins folder. When found, right click on it, select Rename, and change the name of this folder to plugins_temp so WordPress no longer reads it.

edit plugins folder to solve wp-admin not working issue

Now try to access your admin panel. If the problem is resolved and your dashboard now displays correctly, then your blank wp-admin was caused by a plugin.

The next step is to identify the plugin that caused this issue. Here’s how to do this:

With the plugin folder still renamed, login to your dashboard and go to Plugins > Installed Plugins. You will be shown an empty page with a message as seen below.

Blank WordPress admin panel - Reset plugins

Now go back to FileZilla and revert the folder name to “plugins”.

Return folder name to plugins

Next, go to your WordPress tab and hit refresh on the plugins page. You should now see all your plugins, but they are all deactivated.

Activate plugins

Activate plugins one after the other. You will get to the one that causes your wp-admin to stop working. You can the delete that particular plugin and this would solve your blank wp-admin issue.

Remove empty lines and PHP closing tag (?>) from wp-config file

A good number of WordPress users have reported that an empty line at the bottom of their wp-config file resulted in their WordPress admin panel going blank.

Also, ending the wp-config file with the php closing tag “?>” may cause a similar issue. This action may prompt PHP to send output to the browser prematurely.

To check if any of these are causing your blank wp-admin panel, access your files using Filezilla FTP, and your cPanel login details.

You would be able to see your site folders on the bottom right in FileZilla. Double click the folder containing your WordPress files to open it. This folder is usually public_html.

Blank WordPress Admin Panel - public_html folder

In this folder, search for the wp-config file. When found, right click on it, select View/Edit, and permit FileZilla to open the file using your local text editor.

edit wp_config file

Next, check the file to see if it contains an empty line at the end. If it does, clean it off. Also remove the php closing tag from the end of this file.

Remove empty lines

Save the file and allow FileZilla to upload it.

Now try to load your admin panel to see if this solves the problem.

Increase PHP Memory Limit

Sometimes, a blank wp-admin page occurs because WordPress runs out of memory. This can happen if your allocated PHP memory is low.

To rule out this error, you need to increase memory allocation to a large enough value, say 256mb. Here’s how to do this:

Access your files using FileZilla FTP, and your cPanel details.

Your site files will be displayed on the bottom right in FileZilla. Double click the directory containing your WordPress files to open it. This folder is usually public_html.

Edit public_html folder to fix wp-admin not working issue

In this folder, search for the wp-config file. When found, right click on it, select View/Edit, and permit FileZilla to open the file using system editor.

edit wp config to fix wp-admin not working issue

Next, add the following code to increase the allocated memory to 256mb (add this code just under “Define WP Debug”).

define( 'WP_MEMORY_LIMIT', '256M' );


Save the changes and allow FileZilla to upload the new file when prompted.

Now try to access your admin panel. If the problem is solved, then it means wp-admin stopped working because WordPress was running out of memory.

Repair Database

In some cases, a corrupt database could lead to a blank WordPress admin panel. Gladly, your database can be repaired using PhpMyAdmin, and this is quite easy to do.

Note: Before making any changes to your database, we recommend that you back it up first. You can also do this using PhpMyAdmin.

To repair your DB:

Login to your cPanel account.

In the Databases section, click on PhpMyAdmin.

PhpMyAdmin in cPanel - Blank WordPress admin panel

Next, select the database you want to work with.

Select WP database - Fix wp-admin not working issue

All tables in the database will be displayed on the right.

Click Check All at the bottom to select all tables. Next, in “With selected”, select Repair table.

Repair tables - Blank WordPress Admin Panel

When the repair completes, try accessing your admin panel to see if this resolves the issue. If yes, great! But if wp-admin is still not working, then it’s time to debug.

Enable Debug Mode To Fix Blank WordPress Admin Panel

When Debug Mode is enabled, errors preventing WordPress from working normally are displayed onscreen. Because you would not want your readers and customers to see such code errors, this option is disabled by default.

However, these errors can be very helpful when trying to understand why wp-admin is not working.

For example, in the picture below, the error message can help us see why this page is not loading, which is an error in the Pixel-Linear theme.

Debugging enabled - Blank WordPress admin panel

With that information, we can easily pinpoint the reason why wp-admin is not working, and address it.

To enable debug mode:

Access your files using FileZilla FTP, and your cPanel details.

Next, double click the directory containing your WordPress files to open it.Blank WordPress Admin Panel - public_html folder

In this folder, search for the wp-config file. When found, right click on it, select View/Edit, and permit FileZilla to open the file using system editor.

edit wp_config file

Next, search for the line that says:

define('WP_DEBUG', false);


And change false to true, like this:

define('WP_DEBUG', true);


After making and saving this change, allow FileZilla to upload the new file when prompted.

Now try accessing your WordPress Dashboard. Instead of a blank wp-admin, you should get an error message. Study this message to see what it is pointing to. This information should help you find the error causing your blank WordPress admin panel.

 

How Can You Use This Information

If you are currently dealing with a blank WordPress admin panel, the steps covered in this guide should help you resolve it.

Also, whenever you encounter this issue, the first things you should think about are the latest updates you made to your site. Undoing these may resolve your issue.

If your wp-admin is still not working after going through all these steps, we understand how frustrating that must be. At this point, it is best to have it looked at by a professional. You can request our service and one of our WordPress experts will get in touch with you to resolve your issue.

Have you also tried other solutions that helped you with this issue? We would love to hear about them in the comments below.