Have you heard of WordPress $content_width?

The WordPress theme check is a great plugin. For those who haven’t seen it it’s a way to check that you theme covers all of the functionality required to be added to the WordPress.org theme directory. I have been using this plugin to help me test the themes that I am creating on Pro Theme Design.

It covers a surprisingly wide array of tests, making sure that you don’t have any errors, and that you support all the most important elements of WordPress (to provide maximum bang for buck).

One of the features it checks for is use of the $content_width variable – and this isn’t something I have ever seen used or mentioned, so I thought I would do a bit of research into it.


So, it turns out, that the usage is simple. The variable is a global variable that is used to set the width of the content on the site. The only thing this affects is the images uploaded to the image uploader, and videos embedded with the video shortcodes. Setting the variable correctly means that the images will have a resized version that fits perfectly within your content – so it’s definitely a nice thing to include.

The recommended implementation is to add the following to your functions.php file in the theme root.

if ( ! isset( $content_width ) ) $content_width = 900;

Personally I would like to see this variable filterable so that I don’t have to add some random floating code in my functions.php

If you want to try the WordPress Theme Check plugin for yourself then you can download it from WordPress.org.

Let me know what you think on Mastodon, or BlueSky (or Twitter X if you must).

Link to this page

Thanks for reading. I'd really appreciate it if you'd link to this page if you mention it in your newsletter or on your blog.

WordPress News

The latest WordPress updates from the WPBriefs Podcast.

Related Posts

31 May 2007

WordPress tips and tricks – functions.php

Functions.php is a little known wordpress template file. Not many themes take advantage of it but , used properly, it can be incredibly powerful. The file can be used as a way to add your own functions to wordpress themes...
17 Oct 2012

WordPress Social Network Aggregation

I really like the idea of a Tumblog – and even have one on Tumblr.com – but I don’t promote it anywhere. Conceptually it’s great – but I don’t like not having control over my content.What I would really like...
18 Oct 2009

WordPress 2.9 – the_post_image

It was recently announced that WordPress 2.9 includes a new function to get post images called the_post_image. There is some information about the command over on WPEngineer.Having post thumbnails is fantastic, they really liven up a post, but until recently...
09 Jul 2010

Lowercase p, dangit! WordPress Controversy

There has recently been a new piece of code added to the WordPress core which makes sure that people spell WordPress correctly – automatically correcting misspellings (ie. making the P in the middle uppercase).On its own this seems harmless enough...
13 May 2010

6 Tips to Build Better WordPress Themes

If you want to make WordPress themes, for clients, to release for free or to sell, then there are a lot of factors you need to take into consideration. Below are some hints and tips that should help ease your...