Uh Oh! My WordPress Blog Is Blank!!!

Seeing that dreaded blank WordPress page is never a pleasant sight. There are no error message nor any other indication of what might have gone wrong. So finding and fixing the problem can be very frustrating and time consuming.

And as you can probably imagine, with over 50 WordPress websites under our belt, we’ve seen our fair share of blank pages.

So before you pull your hair our, take a look at our list below. Hopefully we can save you some trouble.

Blank WordPress: Things That Might Have Gone Wrong

The list is arranged in order of most common to least common, as from our experience.

1. Incomplete upload of core WordPress files.

If you have just installed or upgraded WordPress and it just shows you that White Screen of Death, you might not have uploaded all of the core files. And even if you are sure that all files are uploaded, its good to upload again just to be sure.

We had this problem, for example, when dealing with a bad web host which repeatedly timed out and didn’t give any indication that files were being selectively uploaded.

Your FTP client could also be at fault.

To ensure complete upload of files, one simple method is to upload the entire zipped directory and then unpack it on the server.

2. Theme files are not uploaded.

If you are upgrading your blog, be sure not to overwrite the wp-content directory. But if theme files have been deleted, you will need to upload them or switch to the default theme to see your blog. Additionally, when moving your blog, be sure to keep the wp-content directory, or at least your theme files.

3. Incompatible Plugins.

Plugins have very limited compatibility and do not function with all versions of WordPress. So before upgrading or installing a plugin, check for full compatibility. Additionally, not all plugins play nice with one another. So you might have to disable or delete any new plugins to restore your website.

4. Bad, Corrupt, or Incomplete Theme Files.

Sometimes, the problem lies with the theme. If you’ve just set a new theme or edited your theme and noticed this error, then go back and undo whatever you did.

5. WP config file

Believe it or not, your wp-config.php file could be the culprit. Colin McNulty, who spent half a day finding the problem on his blog, rants:

You getting it yet? Yep, it’s an empty line. That’s all it is. 1 single solitary NewLine at the bottom off the file, right after that ?> a Carriage Return & Line Feed in programmers speak. That’s it. You hit the Enter key in one wrong place and the whole pack of cards comes tumbling down! Shocking, just shocking.

So, if you are editing your wp-config file, beware! Avoid any unnecessary empty lines. Colin McNulty also advises us to beware of nefarious spaces, because who knows what they’re capable of!

6. Permissions

Depending on your web host, if your files do not have sufficient permissions, then your pages will not be shown. And you’ll get an instance of the Blank Page of Death. For information, on changing permissions, see the WordPress Documentation Changing File Permissions.

7. Not a clue…

If you’ve tried everything and have not been able to find a solution, you might just have to restore your blog from a backup, or simply reinstall WordPress. But before you do so, you might want to try Andrew Ooi’s fix below.

Make WordPress Tell You What’s Going On!

We didn’t even think of this one, but ex-PHP programmerAndrew Ooi did. On his blog, he explains the process of forcing WordPress to give error reporting, thus giving you an alternative to the mysterious blank page.

In a video tutorial, he explains the process of creating an error reporting file called tester.php with the following code:

<?
ini_set('display_errors','1');
ini_set('display_startup_errors','1');
error_reporting (E_ALL);include('index.php');
?>

For full details, visit Andrew Ooi’s blog here.

 

Have a different blank page fix? Let us know.

Tags: , ,

35 Responses to “Uh Oh! My WordPress Blog Is Blank!!!”

  • On December 21, 2008 at 8:44 pm,Mike Landis wrote:

    What if the entire blog is fine except the default page? I can go to /whatever/ and the page is there, the widgets work, the links to other posts and pages all load completely, … except that / is blank after the 2.7 upgrade. The file permissions meet your spec above, it behaves the same if all plug-ins are disabled or if the four I’m using are enabled. The wordpress default theme behaves just as the others do – okay on all pages except the default one. There must be something else.

  • On December 21, 2008 at 9:01 pm,Velvet Blues wrote:

    Well, assuming that you aren’t implementing caching…

    1. How many posts do you show per page? I know of one fix, where someone simply lowered the posts per page to a ‘reasonable’ number. (ie. less than 1000)

    2. If that doesn’t work, do you have any error logs that you can look at? If not, use the code sample above to turn on error reporting… The only other think that I can think of is an incomplete upload of files…

    If you find a solution, please let me know. I’ve visited your site, and this is quite perplexing…

  • On December 21, 2008 at 9:16 pm,Velvet Blues wrote:

    One more thing. When you checked compatibility with the default theme, was it the default theme which came with the 2.7 release? Or was it the default theme in your previous themes folder?

  • On December 21, 2008 at 9:20 pm,Mike Landis wrote:

    Sorry, I included something that looked like an HTML tag…

    There’s no caching enabled. Ten posts per page (I read that post too – he said 2000 wouldn’t work any more (in 2.7), but 1250 would work. I have injected the code above in index.php – no errors are coming out.

    There’s no content missing… I can switch the default page around. After switching, the page that used to be blank will display just fine (if you address it via permalink), but the new default page will be blank (from it’s permalink). The [blog_root] is blank no matter which page is configured as the default content, including configurations showing ‘the last 10 posts’.

  • On December 21, 2008 at 9:26 pm,Velvet Blues wrote:

    Yeh… I am at a loss here. The only think that I’d think might be the problem would be an incomplete upload of WP files, or perhaps an undiagnosed 2.7 bug. I’ll do some research for you and post whatever I find.

  • On December 21, 2008 at 9:32 pm,Mike Landis wrote:

    All themes behave identically, including the wordpress default theme.

    I reloaded the upgrade already. No change.

  • On December 22, 2008 at 10:54 pm,Velvet Blues wrote:

    Mike, I see that your site is up… What solution did you use?

  • On December 22, 2008 at 11:36 pm,Mike Landis wrote:

    First I renamed [blog_root]index.php so wordpress couldn’t find it and tried to get any permalink to load. Of course, everything was broken. Then I put it back and retried. After a very long wait (probably doing some sort of cache cleanup or refresh), I got the default content using its permalink.

    I also found that I could switch the default page around and get whatever was the new default from its permalink too. The [blog_root] was still blank though.

    Then I tried reloading [blog_root] and it came right up (no waiting). So, it appears to have been a browser caching issue.

  • On December 23, 2008 at 7:31 am,Velvet Blues wrote:

    Wow. We’ll I am glad that it is working for you, but it has got to be frustrating knowing that you did a whole lot of research and troubleshooting only to find that the problem was much simpler to fix.

    Thanks for letting me know how you did it.

    By the way, you have an interesting blog. Now that I can freely browse it, I’m quite intrigued. You’ll definitely see me over there. :-)

  • On December 23, 2008 at 7:57 am,Mike Landis wrote:

    It will be nice to see comments that aren’t SPAM. Thanks

  • On June 2, 2009 at 9:10 am,subbu wrote:

    thanks for the tut. the theme was not uploaded and i had to reactivate the default theme for the changes to take effect.

  • On August 10, 2009 at 1:27 pm,Theodore Bagwell wrote:

    I found that I had a habit of uploading index files and other files into my root wordpress directory instead of uploading into my Themes folder, as the files can look almost the same when looking at your directory structure. So re-uploading key wordpress files (excluding wp-config because I didnt want to lose my database info) and then re-uploading my theme files solved my problem quickly.

  • On October 17, 2009 at 2:01 am,BrendanM wrote:

    Another possible error: If you’re using .htaccess to modify your standard URLS into “pretty urls”, ie. www.site.com/index.php?p=4 to www.site.com/my-blog-post.html AND for whatever reason you actually have a physical “my-blog-post.html” in your site’s root directory, your blog page will not load.

    Simply delete the .html files from your site’s root directory that happen to match your dynamically generated “pretty urls”.

    This happened to me after I was copying and backing up files in a non-standard way.

  • On January 11, 2010 at 10:36 am,theCaller wrote:

    well i did that (uploading .htaccess) but i don’t find any html files as you told. I get blank/white for my post link (pages and others are still working).

  • On February 11, 2010 at 3:28 am,sample letters wrote:

    I have this problem on my letters site,

    I can not add new themes or plugin directly, when ever I am doing it, its just goes blank.

    I tried all the points above, Its still the same.

    any suggestions?

  • On March 19, 2010 at 2:36 pm,elisa wrote:

    Hi, I’m a starter and need help…
    Today I checked my site and couldn’t find it. The homepage always shows just a picture, you can’t click further. But if I type other pages like this one: http://www.elisabethida.com/show
    then it works (it shows the real page).
    Can anyone tell me what to do to fix this?
    Thanks a lot before!

    Greetz,
    e.

  • On March 21, 2010 at 11:39 pm,Lheyanne wrote:

    I uploaded a broken theme and deleted it in my server.

    Now, my site is blank. How do I change the theme back to default if if wordpress is blank?

    Anyone? Help? Thanks.

  • On April 16, 2010 at 4:45 pm,lea selley wrote:

    thank you so much… it was totally step 1 – didn’t have all the files moved over! Thank you so much for this!!!

  • On April 24, 2010 at 5:13 am,rafaelromero wrote:

    the changing themes back to the default helped me. Thx!

  • On October 19, 2010 at 10:24 am,Boris wrote:

    Hi, just to say thanks, I was in ‘blank-screen panic’ until I came across this post. As you suggested I was missing a theme, my fault for using a ‘clean install’ and forgetting. Five seconds to switch to the default theme and get the site back, then 30 seconds to ftp the old theme across. (Although I prefer the default theme, so I’ll work on changing that and ditch my old theme) Thanks!

  • On December 2, 2010 at 4:20 am,Letters wrote:

    I faced the same problem on my website few days back but solved it. I reinstalled the wordpress files.

  • On December 18, 2010 at 3:15 am,Malaysia travel wrote:

    This is what happened when I tried eStore wordpress theme, which is something that I couldn’t figure out till now :/

  • On December 20, 2010 at 8:59 am,sample letters wrote:

    I was also very much worried about this problem. Thanks to you for clearing my this problem.

  • On December 27, 2010 at 12:06 pm,Kendosrcboat wrote:

    My site also disappears after i change the permalink option to custom : /%postname%/

    Then All the admin page disappears. Please help.

  • On January 8, 2011 at 11:22 am,Emad wrote:

    Mine was the permissions :)

  • On January 24, 2011 at 10:33 am,Ana wrote:

    Hi!

    Thank you for your help! The culprit was indeed the last blank line of wp-config.php. Who would know that ONE BLANK LINE would cause such a major headache?

    Thanks again.

    Ana

  • On March 14, 2011 at 9:53 pm,Luke wrote:

    http://wordpress.org/support/topic/26-install-caused-indexphp-to-read-silence-is-golden

    Accidentally copied index.php file from the wp-content directory into root directory. Re-copied this code:

    …to my index.php file in the root directory and re-uploaded, and everything worked again.

  • On July 26, 2011 at 3:39 pm,zac wrote:

    I’m using a custom plug-in, where I want to retrieve values from posts (whiche are posts that belong to a custom post type) to list them inside a metabox of some other custom post type.

    So i’m trying to do that using WP_query() inside the plug-in, and that gives me the blank page..

    I imagine that for some reason I can’t use WP_query() inside the plug-in… is there another way I could retrieve these posts?

  • On July 26, 2011 at 3:56 pm,zac wrote:

    I’d like to add this to my previous post:

    I turned debug mode on, and, when I call WP_query() from inside my custom plug-in I get the following error:

    Call to undefined function is_user_logged_in()

  • On July 31, 2011 at 2:05 pm,April wrote:

    I know this is a very old post, but THANK YOU for keeping it up! That single blank line was my issue and I would have never figured it out!!

  • On August 16, 2011 at 3:56 pm,Claude wrote:

    My blank page problem was hard to find because I had nothing whatsoever in HTTPD error_log file. I have 2 Web servers but WordPress was working properly only on one Web server:

    1. In the file wp-config.php, add a line right after the line like “<?php" :
    error_reporting(E_ALL); ini_set('display_errors', 1);

    2. In the same file, also enable debug :
    define('WP_DEBUG', true);

    3. Go to your WordPress site on both servers and check the debugging info that is output in your browser.

    4. I found out that the Simple Lightbox plugin was not loading on the defective Web server. So I disabled the plugin in WordPress.

    5. I can now see the exact error message that is causing the blank page! The blank page problem was because of :
    PHP Fatal error: Allowed memory size of 23068672 bytes exhausted (tried to allocate 32 bytes)

    6. In PHP.INI, I increased the value from 22M to 32M (33554432) :
    memory_limit = 33554432

    Then it solved the problem!

  • On August 19, 2011 at 8:06 am,Velvet Blues wrote:

    @Claude: Thanks for including the details about your problem. It will definitely be helpful to other WP users. I’m glad your issue has been resolved. :-)

  • On August 30, 2011 at 3:56 pm,Jocke Webmaster wrote:

    The tester.php made the thing! Discovered that one plugin started to act strange, took it away, and now the site is working! Thank you very much!

    /Joacim

  • On October 16, 2011 at 2:09 am,hairy wrote:

    thanks for numerous ideas on solving this matter.. finally i just reinstall my wordpress and so far its working fine.. haha..maybe u want take a look at my website & let me know if it went white again.. really appreciate it..

  • On October 21, 2011 at 8:29 am,AJ McClary wrote:

    I’ve gotta hand it to you, the tester.php just saved my life. Thank you so much!

Trackbacks

Trackback URL for this entry:
http://www.velvetblues.com/web-development-blog/my-wordpress-blog-is-blank/trackback/

Leave a Reply

Want us to work on your project?

Contact us today for a quote. Click here to submit details regarding your project.

If you are making a general inquiry, send an email to info@velvetblues.com