Plugin Directory

!This plugin hasn’t been updated in over 2 years. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress.

Custom Background Extended

Allows users to create a custom background on a per-post basis.

Why was this plugin created?

I've always been interested in art direction on blogs. This is just one tool of many that I'm creating and making available via my Web site for making it easier for users to take more control over their styles on a per-post basis.

Why doesn't it work with my theme?

Most likely, this is because your theme doesn't support the WordPress custom-background theme feature. This plugin requires that your theme utilize this theme feature to work properly. Unfortunately, there's just no reliable way for the plugin to overwrite the background if the theme doesn't support this feature. You'll need to check with your theme author to see if they'll add support or switch to a different theme.

My theme supports 'custom-background' but it doesn't work!

That's unlikely. Just to make sure, check with your theme author and make sure that they support the WordPress custom-background theme feature. It can't be something custom your theme author created. It must be the WordPress feature.

Assuming your theme does support custom-background and this plugin still isn't working, your theme is most likely implementing the custom background feature incorrectly. However, I'll be more than happy to take a look.

How do I add support for this in a theme?

Your theme must support the Custom Backgrounds feature for this plugin to work.

If you're a theme author, consider adding support for this if you can make it fit in with your design. The following is the basic code, but check out the above link.

add_theme_support( 'custom-background' );

Can other users on my site add backgrounds?

Some sites have multiple writers/authors who write posts. However, since custom backgrounds tend to be a design-related option, only administrators have access to altering backgrounds in a default WordPress install. There is a way around this, which is to give permission by assigning a capability to user roles.

In order to manage capabilities and roles, you need a plugin like Members, which is a plugin I created for managing sites with multiple users. It's something you should be using for any site with multiple levels of users (i.e., all users are not admins). This plugin will allow you to add or create new capabilities for any role.

The capability required for being able to add per-post backgrounds is one of the following:

  • cbe_edit_background - The user can edit backgrounds on posts they have written.
  • edit_theme_options - The user can edit all WordPress theme options (not recommended for anyone other than administrators).

Using the Members plugin, you can assign one of the above capabilities to allow other, non-administrator users to edit backgrounds for their posts.

Also, a user must have the upload_files capability to upload new images, but this is a WordPress thing and not specific to the plugin.

Does it support custom post types?

The plugin supports WordPress posts and pages out of the box.

Because it's impossible for me to accurately determine what a custom post type should do, I've left it up to those of you actually building custom post type plugins to support this. If you'd like to allow custom backgrounds on singular views of your post type, add 'custom-background' to your post type supports array during registration. Obviously, your post type would need to be publicly queryable and display something on the front end for single post views.

Or, if you have a plugin with post types that you'd like for me to add support for, let me know. I'll be more than happy to add the support via this plugin.

Can you help me?

Unfortunately, I cannot provide free support for this plugin to everyone. I honestly wish I could. My day job requires too much of my time for that, which is how I pay the bills and eat. However, you can sign up for my support forums for full support of this plugin, all my other plugins, and all my themes for one price.

Requires: 3.6 or higher
Compatible up to: 3.7.14
Last Updated: 3 years ago
Active Installs: 4,000+


5 out of 5 stars


Got something to say? Need help?


Not enough data

0 people say it works.
0 people say it's broken.