WordPress Development Stack Exchange is a question and answer site for WordPress developers and administrators. Join them; it only takes a minute:

Sign up
Here's how it works:
  1. Anybody can ask a question
  2. Anybody can answer
  3. The best answers are voted up and rise to the top

I'm developing a custom WordPress theme. When I go to select themes in the Appearance menu, my theme does not have a preview image. Is there something I need to do to get a preview image to show up? I can't find any resources on the web that talk about this. Maybe I'm just searching the wrong thing though...?

share|improve this question
Found it-- I was searching the wrong thing, but this also isn't very well documented. In order to get a screenshot to show up for your theme, you need to include a file called screenshot.png in the root folder of your theme. This is preferably 300x225 but that isn't required. – Chiubaka Sep 1 '11 at 6:36
You should post this as Answer, so you can mark it as solution. Else the Q will stay open forever. – kaiser Sep 1 '11 at 7:32
I know, I couldn't because I don't have a rep of 100 or above before. – Chiubaka Sep 1 '11 at 20:31
up vote 12 down vote accepted

There is no automatic preview. You need to create the screenshot yourself and place it in the theme/child theme folder named screenshot.png


share|improve this answer

For wordpress.org themes, the screenshot should be reasonable facsimile of the theme, and should be 880px wide and 660px in height (any 4:3 height:width) screenshot will be fine.

To add a screenshot, create screenshot.png file and add it to the root director of the theme. e.g wp-content/themes/theme-name/

How to create a screenshot of the theme.

You can use screengrab, awesome screenshot or any other firefox addon or chrome extension to take screenshot and set height and width in photoshop. You can also use built-in feature of firefox for this reason.

Click on alt button on your keyboard and you will see a menu at the top of the browser, Click on tools > web developer > responsive design view, now set custom height width and take screenshot

share|improve this answer

Your Answer


By posting your answer, you agree to the privacy policy and terms of service.

Not the answer you're looking for? Browse other questions tagged or ask your own question.