Search Over 30,000 FREE Plugins from the Official WordPress Plugin Directory Repository


This plugin allows you to create a custom background on a per-post basis. It supports posts, pages and product pages out of the box.

This plugin is no longer maintained. It's functionality is included in almost every WordPress theme nowadays. This is a plugin that allows you to set a custom background on a per-post basis. This plugin hooks into the WordPress custom-background theme feature and overwrites the values on single post views if the post has been given a custom background.

Author Demis Patti
Contributors demispatti
Tags admin, background, Bild, color, eigener, eigenes, Hintergrund, Hintergrundbild, image, images, Post, posts
  1. cb-static screenshot 1

    Multiple background views of a single post.

  2. cb-static screenshot 2

    Custom background meta box on the edit post screen.

  3. cb-static screenshot 3

    Custom background meta box.

  1. Upload the "cb-static" folder to your "/wp-content/plugins/" directory.
  2. Activate the "cbStatic" plugin through the "Plugins" menu in WordPress.
  3. Edit a post to add a custom background.

Version 1.0.2

  1. A script now handles the image

Version 1.0.0

  • Code cleanup
  • Optimized the meta box
  • Corrected support for background color
  • Updated readme file

Version 0.1.0

  • First release :-)

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 Justin Tadlock 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:

  • 'cb_static_edit' - 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, pages and products out of the box.

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. I honestly wish I could.

This plugin is inspired by Justin Tadlocks great plugin named Custom Background Extended. So donations should take place at


This plugin creates a custom meta box on the edit post screen. From that point, you can select a custom color and/or image. If you select an image, you'll be presented with additional options for how the image appears on the site.


Your theme must support the core WordPress implementation of the Custom Backgrounds theme feature.

PHP version 5.4 or above.

Version 1.0.2

Requires WordPress version: 3.9 or higher

Compatible up to: 4.4.7

Last Updated 15 Feb 2017

Date Added: 28 Jul 2015

Plugin Homepage


0 stars
0 ratings


Not Enough Data

Works: 0
Broken: 0