When you enables Custom_Headers support for your theme with the following code, a "Display Site Title and Tagline" checkbox on the Site Identity section and a "Header Text Color" control on the Color section will appear:

 * Set up the WordPress core custom header feature.
function theme_custom_header_setup() {
    add_theme_support( 'custom-header', array(
        // Default arguments
    ) );
add_action( 'after_setup_theme', 'theme_custom_header_setup' );

My question is, how can I create another "Display Site Title and Tagline" checkbox, "Header Text Color" setting and control with the same functionalities as listed?

  1. The color control will deactivate/disappear when the checkbox is unchecked asynchronously, not refresh, and reappear when checked.
  2. The controls only have 1 setting because when the checkbox is unchecked, the "header_textcolor" setting will turn to have the 'blank' value.

I tried to create 1 setting with 2 controls but doesn't seems to work:

function theme_customize_register( $wp_customize ) {

    $wp_customize->add_setting( 'tagline_textcolor', array(
        'transport'   => 'postMessage',
    ) );
    $wp_customize->add_control( 'tagline_textcolor', array(
        'type'        => 'checkbox',
        'section'     => 'title_tagline',
        'label'       => __( 'Display Tagline Text', 'theme_name' ),
    ) );
            new WP_Customize_Color_Control(
                        'label'           => __( 'Tagline Text Color', 'theme_name' ),
                        'section'         => 'title_tagline',
add_action( 'customize_register', 'theme_customize_register' );

Can you help me with this, or give me a right idea?

  • As far I understand, each setting has its control. Anyway, you said "it doesn't seems to work" but you has not explained what/how it is not working. Can you, please, describe more accurately what problems do you have to make it working?
    – cybmeta
    Aug 9, 2016 at 9:02
  • @cybmeta Thanks for responding, and yes you're right, my 'checkbox' is not appearing because it's preceded with my WP_Customize_Color_Control(), only color control is appearing. What I want is the same functionalities as “Display Site Title and Tagline” checkbox, “Header Text Color” setting and control. Aug 9, 2016 at 9:08
  • Sorry, but "I want this" doesn't describe the problem you have to do it. If you are not more specific, the answer would be a full explanation of the Theme Customization API. You have such explanation already in the Codex (older) and in Theme Handbook (newer), replicating it here is ducplicating resources. I think you could start by reading those resources, try to build a basic customizer option to learn how it works and come back if you have problems in the process.
    – cybmeta
    Aug 9, 2016 at 10:01
  • No @cybmeta it's simple as creating another Display Site Title and Tagline checkbox, Header Text Color setting and control. If you try to add_theme_support( 'custom-header' ) (PHP) you will see those controls.. Actually, I already have 2 settings with 2 controls but I want to improve them as wp.customize.instance( 'header_textcolor' ).get() (JS) functionalities. Aug 9, 2016 at 11:12

1 Answer 1


If the setting and controls are added exactly as they appear in class-wp-customize-manager.php the JQuery script in wp-admin/custom-header.php will toggle the header text color control properly. The theme_supports line must be commented out or removed as it is "used to hide a setting if the theme lacks support for a specific feature".[1]

add_action( 'customize_register', function ( $wp_customize ) {

    $wp_customize->add_setting( 'header_textcolor', array(
        // 'theme_supports' => array( 'custom-header', 'header-text' ),
        'default'        => get_theme_support( 'custom-header', 'default-text-color' ),

        'sanitize_callback'    => array( $wp_customize, '_sanitize_header_textcolor' ),
        'sanitize_js_callback' => 'maybe_hash_hex_color',
    ) );

    $wp_customize->add_control( 'display_header_text', array(
        'settings' => 'header_textcolor',
        'label'    => __( 'Display Site Title and Tagline' ),
        'section'  => 'title_tagline',
        'type'     => 'checkbox',
        'priority' => 40,
    ) );

    $wp_customize->add_control( new WP_Customize_Color_Control( $wp_customize, 'header_textcolor', array(
        'label'   => __( 'Header Text Color' ),
        'section' => 'colors',
    ) ) );

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Not the answer you're looking for? Browse other questions tagged or ask your own question.