DEFINITION: Custom Background
Custom Backgrounds is a theme feature in WordPress which allows theme developers to enable support for background color and image customization. If custom backgrounds support is enabled in a theme, then the users can upload their own background images to use with the theme, or select a background color. The option to change background colors or change the background image is found under Appearance in the sidebar of WordPress Admin Panel.
Users will also be able to see the live preview as they set the background image.
The feature can be added to themes and enabled by modifying the functions.php file. The process for doing this is shown below.
How to Add Custom Backgrounds Support to a WordPress Theme
To enable custom background support add the add_theme_support() function in your theme’s functions.php file with the following configuration.
1| $defaults = array(
2| 'default-color' => '',
3| 'default-image' => '',
4| 'default-repeat' => '',
5| 'default-position-x' => '',
6| 'default-attachment' => '',
7| 'default-callback' => '',
8| 'admin-head-callback' => '',
9| 'admin-preview-callback' => ''
11| add_theme_support( 'custom-background', $defaults );
If you want to preset a default background image for a theme, then change the default-image option to add the location of the image you want to use.
« Back to Glossary Index