admin-plugins author calendar category facebook post rss search twitter star star-half star-empty

Tidy Repo

The best & most reliable WordPress plugins

Free Theme-Check

Please read! This plugin has not been updated in over 6 months. It may no longer be maintained or supported. There may be compatibility issues when used with the latest version of WordPress. We suggest finding a similar, alternative plugin. Learn more about outdated plugins.


Plugin Author: Simon Prosser

Jay Hoffmann

September 18, 2013 (modified on October 28, 2019)

Developer, Theme

If you develop themes for WordPress, and especially if you are submitting them to the Themes Directory, you have to make sure you follow the latest theme guidelines. And there are a lot of them. Theme Check runs your theme through a series of tests and finds the places where things may be missing.

What’s It Do?

Theme Check will check your theme against the latest theme guidelines and point out any problems that might exist. If there is a problem, it will point out where in your theme the problem exists, and what specification to check out. It uses the same tools that the theme review team uses, so if your theme passes Theme Check, you shouldn’t have a problem submitting it to the directory.

Errors are grouped into categories, so you can easily tell if something is recommended, required, or absolutely essential.

How’s It Work?

Theme Check is on the simpler end of the plugin spectrum. Once you activate it, there will be a new menu option in your admin panel under Appearance -> Theme Check. At the top you will see a drop-down menu listing every theme you have on your site. Next to that is a button that says “Check It!” and a checkbox labeled “Suppress INFO.” I’ll come back to this checkbox in a bit, but for now, leave it unchecked. Select the theme you want to check from the drop-down and click the Check It button.

Select your theme to run a check

Select your theme to run a check

Theme Check will take anywhere from a few seconds to half a minute or so to run through your theme files and check for any errors. After that, it will display your theme information and give you a list of errors.

Hopefully, you won't have this many errors.

Hopefully, you won’t have this many errors.

Each error will have a description of what the problem is, the line or general file in the theme that needs to be corrected, and a big, all caps category next to it. Categories break down like this:

  • WARNING – lines of code or functions that should absolutely not be in your theme. This includes things like base64 encoding, improperly used functions, and any code that will conflict with SVN repositories. This code should be removed from your theme.
  • REQUIRED – items required by the Theme guidelines but are not included in your theme. For instance, you must specify a content width and make sure to have a license, readme, etc. Make sure you correct these problems.
  • RECOMMENDED – Suggestions about features that are recommended by the Theme guidelines, but not absolutely required. Like using older versions of functions, or not specifying custom backgrounds and headers. It is good to go through these ones by one and add whatever you can, especially if you are submitting to the Theme Directory.
  • INFO – General problems and small red flags that may exist in your themes, such as hard-coded links or improper use of PHP/HTML. Definitely go through these and make sure that if you see a warning, it is for good reason. If you don’t want to see any warnings in the “Info” category you can turn it off by checking the “Suppress INFO” button at the top of the options panel.

Go through all of the flags, and make sure that you change items marked in red, and pay attention to items marked in green and blue. When you have made your changes, run Theme Check again to make sure you didn’t miss anything.

Costs, Caveats, Etc.

Theme Check is free to use. It’s generally updated when WordPress is, and especially when WordPress updates its Theme Guidelines. If you spot a problem with it, head over to the support forums to report it.


Plugin Info
  • Downloads: 2,371,443+
  • Downloads trend (30d): -6.2%
  • Active installations: 30,000+
  • Rating:
  • Last Update: December 20th, 2023
  • Download Plugin for Free