WordPress has been offering a great platform to its users. It’s clean and easy-to-use back end always kept it on top in the list of CMSs. The simple reason behind WordPress popularity is the ease it provides to manage the website by your own way. Also, you will be amazed to see the customization options that WordPress offers.

Most of the WordPress website owners often prefer adding custom features to add personal touches to their dashboard. For users, who spend substantial amount of time in the admin area, changing colors can bring a refreshing experience to the way they work.

Changing colors for different admin areas like the posts categories, front-end background etc., isn’t a new concept. Of course, you can do so by simply adding a custom CSS field. But, let’s face it! Not all of us are good at CSS. Fortunately, WordPress 3.5 introduced a new “Color Picker”, making it easy for you to change the color scheme with just a click of a button.

This post is about using a color picker to implement the option for changing background color (in the form of CSS3 gradients) of your posts on the front end.

How to Create a Custom MetaBox With Color Picker?

In the course of this tutorial, we will take a look into step by step approach to implement color picker in a metabox. Follow the steps given below and add the following code snippets to your functions files that will add metabox in your WordPress post screen with color picker field.

Step 1 – Register Custom Metabox

function wdm_add_meta_box() {
	add_meta_box('wdm_sectionid', 'Post Background', 'wdm_meta_box_callback', 'post');

This code will register our custom metabox. It contains a default WordPress function: add_meta_box() that takes some parameters to tell WordPress about the meta box:

  1. wdm_sectionid: HTML ‘id’ attribute of the edit screen
  2. Post Background: Title of the edit screen
  3. wdm_meta_box_callback: This is a function that prints out the HTML for the edit screen.
  4. post: This argument determines that the metabox will appear on your post editor screen. You can use replace it with ‘page’ if you want to use the metabox on page screen.

Step 2 – Creating Custom Metabox

add_action( 'add_meta_boxes', 'wdm_add_meta_box' );

function wdm_meta_box_callback( $post ) {
	wp_nonce_field( 'wdm_meta_box', 'wdm_meta_box_nonce' );
	$color = get_post_meta( $post->ID, 'post_bg', true );
	<div class="custom_meta_box">
	<label>Select Post Background Color: </label>
	<input class="color-field" type="text" name="post_bg" value="<?php echo '#'.$color; ?>"/>
	<div class="clear"></div> 

This part of the code will create a custom function wdm_meta_box_callback( $post ) that helps to generate the output of the metabox. And the add_action( ‘add_meta_boxes’, ‘wdm_add_meta_box’ ) function is a WordPress action hook that tells WordPress to add metabox.

Step 3 – Saving Metabox

function wdm_save_meta_box_data( $post_id ) {
	if ( !isset( $_POST['wdm_meta_box_nonce'] ) ) {

	if ( !wp_verify_nonce( $_POST['wdm_meta_box_nonce'], 'wdm_meta_box' ) ) {
	if ( defined( 'DOING_AUTOSAVE' ) && DOING_AUTOSAVE ) {
	if ( !current_user_can( 'edit_post', $post_id ) ) {
	$post_bg = ( isset( $_POST['post_bg'] ) ? sanitize_html_class( $_POST['post_bg'] ) : '' );
	update_post_meta( $post_id, 'post_bg', $post_bg );
add_action( 'save_post', 'wdm_save_meta_box_data' );

The wdm_save_meta_box_data($posy_id) function is used to save the metabox value to WordPress database.

For doing so, it requires ‘post id’ that save that metabox field value on the particular post meta session in database. The add_action (‘save_post’, ‘wdm_save_meta_box_data’ ) is a hook that tells WordPress to save the post with meta value.

Now that you’ve come to know how the code works, you would like to see the outcome. The above code generate the input filed with name “Post background color”, as you can see in the below screenshot.

Wordpress color picker

How to Use Color Picker?

Although, the metabox with the color picker is created, but you still can’t use the color picker. In order to use it, copy and paste the below code in your theme’s functions.php file:

function wpse_80236_Colorpicker(){
	wp_enqueue_style( 'wp-color-picker');
	wp_enqueue_script( 'wp-color-picker');
add_action('admin_enqueue_scripts', 'wpse_80236_Colorpicker');

Note: As we had discussed previously, Color Picker API was introduced with WordPress version 3.5, and so if you want to use this function then make sure that your website is running on WordPress version 3.5 or later.

Next, paste the below script code inside your wdm_meta_box_callback( $post ) function to generate the metabox.

(function( $ ) {
	// Add Color Picker to all inputs that have 'color-field' class
	$(function() {
})( jQuery );

Once this script is executed, the “Color Picker” will be visible in your WordPress website admin panel.

If you need to get color code ids, simply add the following line of code in your functions.php file.

$post_background = get_post_meta( get_the_ID(), 'post_bg', true );
echo $post_background // here is your color code

That’s it! The color picker will be implemented into your metabox in your website backend. You can add the color picker to any other area in your admin panel following the same approach as we had discussed above.

Sophia Phillips

Sophia Phillips's forte is WordPress developer and her work exists at the intersection of web development and technology blogging. Sophia is professionally associated with WordPrax Ltd. that has been taking huge strides in the web domain consistently and dominatingly.


Please note: We reserve the right to delete comments that contains snarky remarks, offensive or off-topic. To know more read our comments policy.