How To Be a WordPress.com Detective
Last year, we looked at the art and science of getting good WordPress support.
Now, let’s jump into some of the more advanced troubleshooting techniques you can use to tackle the trickier problems you might come up against.
Have you heard the old joke:
Patient: Doctor, it hurts when I do this.
Doctor: Then don’t do that!
With advanced troubleshooting it’s exactly the opposite! You want to be able to reliably reproduce your symptoms. Knowing exactly how to recreate the problem will be a huge help in figuring out how to fix it.
Your visual editor isn’t loading! You can’t drag-and-drop widgets! Your sticky posts aren’t sticking!
Finding the cause of a WordPress.com problem is like detective work. You look for clues. You find likely suspects. You narrow down the perpetrators.
The first question to usually ask yourself is: What did I change most recently? Undoing your last action very often finds the culprit immediately. But sometimes it’s not that easy, and you need to roll up your sleeves and hunker down in troubleshooting mode.
Most problems fall into one of several distinct buckets. With experience you’ll start to guess which bucket yours falls into. Let’s look at them.
Theme
You can rule out a theme-specific issue quickly by temporarily switching to a different theme. Picking a rigorously-tested default WordPress theme like Twenty Twelve, Twenty Thirteen, or Twenty Fourteen is a good bet. If you don’t see the problem with one of those, you know the issue is likely related to your theme.
Heads-up: once you switch back to your original theme, you may need to reset theme-specific settings under Appearance → Theme Options, or Appearance → Customize → Theme Options. If you have custom CSS, you may need to restore it from your revisions.
Post
Sometimes the content of a specific post is enough to mess up your site. Often, this happens if you paste content from another program, like Word or an email app, without turning it into plain text first. A typical sign of bad code in a post is that your sidebar has dropped below the rest of your page content. It can be tricky to figure out which post is causing the problem, but one way to troubleshoot is to temporarily set your blog to display one post at a time and turn off Infinite Scroll, both under Settings → Reading. Now you can easily navigate through one post at a time until you find the culprit.
If you’re comfortable looking at HTML code, you can also try validating your site’s HTML using a tool like the W3C markup validator. It can show a stray or unclosed tag that’s throwing your layout off.
Heads-up: if you paste plain text into the post editor, be sure to add back formatting and links using the buttons in the Visual Editor.
Custom CSS
The ability to add your own custom CSS opens the doors to a huge array of customizations you can make to your site.
If you suspect some CSS might be picking a fight with your site, try removing all your custom CSS temporarily. If your problem goes away, then you know the culprit is living somewhere in your CSS. Add back one or two CSS styles at a time, checking your site after each bit, until you find the culprit.
Browser
Very often, an issue is specific to one Web browser. Fortunately, verifying this kind of problem is pretty easy to do, and doesn’t require touching your site. All you need to do is check your site in another browser. It’s always a good idea to have at least two or three popular browsers installed on your computer to make sure your site looks right, since not everyone uses the same browser as you. Chrome, Firefox, Opera, Safari (for Mac) and Internet Explorer (for Windows) are popular browsers. You can quickly find the latest versions over at Browse Happy.
If you do see that the issue is only happening on one browser, what then?
Browser Cache
Clearing your browser cache as a solution to all woes is a bit of an inside joke within tech-support circles, akin to asking someone to turn their computer on and off. Here’s the thing: it often works!
So, what does clearing your cache actually do?
Browsers save files from sites you’ve already visited to make it quicker to load it the next time. But sometimes those files didn’t get loaded fully, and may prevent the site from working properly in the future.
Clearing the cache is like cleaning off your plate before putting more food on it. You won’t taste garlic on your chocolate cake if you clean it in between courses!
Browser Extensions/Add-ons/Plugins
Many people run extensions, plugins, or add-ons to add extra bells and whistles to their browser. They sometimes interfere with the proper display or functioning of your site – for example, an ad-blocking extension might mistakenly see a banner on your site as an ad, and hide it.
Turning off all browser extensions to see if your issue goes away is a quick way to rule them out as the cause. If the problem does disappear, you can turn them back on one at a time to find the culprit.
In some browsers like Firefox you can turn off all extras quickly by running the browser in “safe mode” – this temporarily returns your browser to a basic state by deactivating all the fancy stuff.
Heads-up: remember to reactivate your browser extensions after you’re finished troubleshooting.
Browser Cookies
Removing individual browser cookies just for your WordPress.com site can sometimes solve a sticky issue, particularly those related to login problems.
Setting your browser to not accept third-party cookies can also cause issues, particularly when previewing posts on a site with a mapped domain.
Heads-up: Try to avoid clearing all cookies, since this can remove saved login info for all sites you regularly visit. Most browsers let you pick and choose which specific cookies you want to clear.
Platform and Operating System
Remember that not everyone uses the same platform you do – there are all manner of Macs, PCs, Linux, Android, and iOS devices floating around. Sometimes a site will work fine everywhere except one particular OS – say, iOS 7.0.4 on iPad minis. Knowing on which specific setup your site is running into trouble can be a huge help.
For example, some older versions of Internet Explorer don’t support responsive-first design techniques, so more recently crafted themes designed to look good on mobile platforms simply aren’t going to display properly.
Heads-up: remember to tell support staff on what platform and OS you saw an issue, particularly if it’s a mobile OS. If you’re not sure what operating system you’re running, visit Support Details.
Security Software
Some anti-virus and other security software can interfere with the proper display of sites, whether it’s blocking images or not connecting with WordPress.com’s servers at all. This sometimes crops up at large organizations that aggressively restrict what sites can be viewed by their employees. Try varying where you view your site, whether it’s home/office/school/library. If you can, try turning off your security software temporarily to see if the problem persists.
Heads-up: remember to reactivate your security software after testing.
Computer
Sometimes an issue is specific to the settings on one machine. Think about whether you recently changed anything on your computer? Did you upgrade the operating system? Install anti-virus software? Fiddle with your network settings? Change them back to how they were before and see if your site issue goes away. Try your site on another computer – ask a friend or colleague, visit the library, or make a pilgrimage to the Apple Store. 😉
Heads-up: if you have both a laptop and desktop machine, test your site on both.
Network
I won’t lie. Networking issues can be some of the trickiest ones to diagnose and fix. Often they affect not only your site, but all sites running on WordPress.com.
Symptoms of possible network-related issues include a slowly-loading site, certain elements not loading at all, or images looking fuzzy.
Suspected network issues can require a bit of work on your end to get support staff the information we need to get to the bottom of the cause. We may ask you to do something that might be a little scary-sounding, like run a traceroute or check the JavaScript console – but don’t worry, we have guides on how to do those things and we’ll walk you through it if you have any trouble.
Heads-up: Be sure to provide all the information you’re asked for by support staff. It may seem like a lot, but the more complete your info, the more efficiently we’ll be able to help you.
The more troubleshooting you do, the easier it gets to recognize potential causes of different kinds of issues – and their solutions. A great way to get experience is by moseying through the WordPress.com support forums regularly and watching how experienced volunteers and staff help others. Once you’ve dipped your toes in, try answering few questions yourself. You’ll probably discover you know more than you think!
You still need phone support. Some of us are not that PC smart.
LikeLike
Best. Post. Ever. *insert happy blogger face here*
LikeLiked by 1 person
Funny that this should come up right now. My theme went wonky on me last night for no reason I could pin down, so I migrated to a new template and it’s fine. All the text went pale silver. I hadn’t changed colors or fonts — and changing them didn’t affect the font color which just got paler and paler until it was nearly invisible (Zoren). It was much easier — and faster — to migrate to a new theme than to track down the problem. Whatever ailed it was clearly theme specific. Fortunately, there are many themes that work for me. I like the new one – Suits – better anyhow.
Lee is right. Even those of us who ARE PC smart can’t always track down the cause of a problem. Phone support would be deeply appreciated!
LikeLike
GREAT POST! I’m saving it in ‘references’. I think I want a cheeeep site that nevertheless I ( and you) can run ads in. I need more exposure to sell in.
Lee
LikeLike
If you want to run ads on a WordPress.com site, feel free to check out our WordAds program.
LikeLike
Good information, thanks!
LikeLike
A useful checklist but leaves out some important information. CSS? What’s that? Clear the cache? How do you do that? It’s easy for techies to forget how ignorant the rest of us are!
LikeLike
I hear you! If you’re brand-new to websites and troubleshooting, this article may be a little advanced. You can learn more about CSS through the link I gave above – it gives a good overview. We link to some instructions on how to clear your browser cache from the Browser Issues page.
LikeLiked by 1 person
Thanks for the super-fast reply! Just something as simple as saying what the letters stand for would be a good start and would help us feel less stupid! It’s all about building confidence.
LikeLike
Excellent information – I’m saving for future reference!
LikeLike
great post madam..
i wanna be 😀
still having problem with CSS
LikeLike
ipanase – glad you liked the post! If you need help with CSS feel free to post in our CSS Customization support forum. Lots of helpful folks there!
LikeLike
as newbie on this class ( CSS ), thanks madam ….. glad with your response 😀
LikeLike
Good info for a WordPress novice like me 😉
LikeLike
This is helpful! I hadn’t found the support forums yet.
LikeLike
Thanks, I was having trouble with weird code showing up whenever I posted from ms word onto the post box, but now to first turn into plain text first.
LikeLike
Very good post. Neatly summarised covering a load of issues. Mind you, I do pull my hair out when someone tells me a) to turn the computer on and off b) to clear the cache and c) to resent Safari (my main browser). I’ve invariably done all that and more before I ask for help. But still, it’s worth reminding people. It’s also one of the reasons I close everything down at night. When I go to sleep so does my computer. We all need a rest. Non-techy speak there but shutting down means the cache is emptied, etc etc.
I only know Macs, but often it is worth keeping your computer clean, so for example, I use disk utility to see if there are any broken permissions, and repair those. No idea what the windows equivalent is.
LikeLike
Thanks wordpress! I love that you offer such great guidance and support, especially for us newbies). I’m certainly no computer whiz, but i’m happy that I got my site up and going and even though no pictures yet i’m happy with my site (for now). Check me out @ http://www.chely5150@wordpress.com
LikeLike
Nice work. 🙂 Some of it kind of reminds me of the “How To Ask Questions The Smart Way“.
If you ask me, your post belongs into the support pages. Maybe in the FAQ category. At least the procedure of finding the problem (from general to specific) is something that is missing in Help! Getting WordPress.com Support.
LikeLike
Martin – thanks for the kind words and for the the idea. I added a link to the post from the “Help!” page, as you suggested.
LikeLiked by 1 person
Very helpful post. Saved for reference later. Thank you!
LikeLike
Thanks a lot. You gave me a lot of ideas.
LikeLike
Very helpful and appreciate your effort with this sort or post.
LikeLike
Additional info: Your foto/ JPG upload is impossible? You get a ERROR – message? Delete the EXIF dates from the pic. Forget delete “Cache” or “Cookies” or trying any “Browser changes”.
LikeLike
Great article, and very informative.
LikeLike
I have always been uncertain about my menus in my blog. I would appreciate a full walk through of setting up and maintaining a menu, therefore.
LikeLike
We have a full guide to setting up custom menus, or if you need help setting up the menus in your particular theme, feel free to ask for help in the support forums.
LikeLike
Gotta love it! Yes. One must be proactively engaged at all times!
LikeLike
Oh my you are so impressive.
LikeLike
Great article, I consider myself fairly computer literate and take pride in doing some troubleshooting before asking questions I’ll be keeping this one in the memory banks. Thanks
LikeLike
Very helpful. Clearly written. Thanks for being an excellent role model.
LikeLike
Excellent article! I appreciate having the different steps outlined like that — thanks for sharing!
LikeLike
This is a very timely post for me. As a blogging novice I am seeking to resolve one or two irksome quirks in my WordPress world at the moment. I am hopeful that some of these troubleshooting pointers will help. Many thanks.
LikeLike
UPDATE: I am pleased to report that with the aid of this problem-solving post (and a bit of help from one of my technical whizz-kids) I have been able to resolve my minor glitches with WordPress. We discovered it was an easily rectified browser/cookies issue. I have saved this post for future reference! Thank you.
LikeLike
Very glad to hear you were able to solve your issues – good stuff!
LikeLike
An article of great help! I being new to wordpresstill now have never faced any of these problems but it was better to know in advance what problems I can face and I know where to come back if I ever face any issue
LikeLike
Thank you for another excellent addition to the Support self-help articles. I learned something new too. 🙂
LikeLike
Thanks a lot, Jen. I’m tickled that you learned something!
LikeLike
I like the “Doctor it hurt when I do this”! thanks for sharing.
LikeLike
When I try to update my wordpress/themes, I get this error message: Fatal error: Call to undefined function mbstring_binary_safe_encoding() in /srv/disk1/1180940/www/entrepreneur.homepublishingonline.com/wp-admin/includes/class-wp-filesystem-direct.php on line 62.
What can I do?
LikeLike
Hi wiggy2bad, since that’s a self-hosted WordPress site – where you install the software on your own host – you can try posting in the WordPress.org support forums for assistance: http://wordpress.org/support/
Good luck!
LikeLike
Hello,
I have the most weird experience whit my WordPress blog.
I want to suspend my blog as soon as possible and can not do it !!!
there is NO WHEY to set Dashboard>Settings>Reading>Site Visibility Click on the third option “I would like my site to be private…”
Watt is this everything is just blocked in this blog.
Thanks for your Help.
LikeLike
Hi there – if you have a WordPress.com site, try posting in the support forums where people will be able to help you more directly: https://wordpress.com/forums/ You can also check out some tips on getting help in the forums. If you’re running a self-hosted site on your own host, those forums are here: http://wordpress.org/support/ Good luck!
LikeLike
informative very thanks you help me to solve many problems
LikeLike
Thank youuuu!!!!
LikeLike
great post. very informative. Thank you Kathryn.
LikeLike
Thanks so much for this post! I have 2 posts on my site that are causing my sidebar to drop below the rest of the content and one of those posts is doing all sorts of weird and wonderful things. I had a look at the markup validator link you provided but unfortunately it is wayyy to advanced for me. Any other tips or suggested reading?
LikeLike
Hi frankiesfeast – I suggest you post in the support forums where folks can help you more directly: https://wordpress.com/forums/ You can also check out some tips on getting help in the forums. Good luck!
LikeLike
Kathryn, I am keeping this post because it will be the first thing I turn to the next time I have issues. Thank you for your clarity!
LikeLiked by 1 person