Make WordPress Core

Opened 5 years ago

Last modified 4 years ago

#46128 new defect (bug)

Custom header "Hide image" button not displayed when randomizing images via theme setup

Reported by: webmandesign's profile webmandesign Owned by:
Milestone: Awaiting Review Priority: normal
Severity: normal Version: 3.4
Component: Customize Keywords: has-patch needs-testing
Focuses: Cc:



When registering multiple custom header images via theme code, and setting them to randomize (by enabling random-default custom header attribute), there is no "Hide image" button displayed. But the image should be displayed even in this case.

The only way to enable "Hide image" button is to set default-image attribute during custom header registration in the theme code. But this actually effectively disables images randomization...


Append this code to Twenty Nineteen theme's functions.php file (without opening <?php) to test - see the code comments for more details:


function test_custom_header_hide_button() {

         * Registering custom header support.
         * The issue description:
         * ======================
         * When 'default-image' is set, there is "Hide image" button
         * displayed in "Header Image" section of customizer. But now
         * the 'random-default' does not work.
         * On the other side, if 'default-image' is not set, "Hide image"
         * button is not displayed in "Header Image" section of customizer
         * when we have 'random-default' enabled.
         * In both cases the "Hide image" button should be available.
         * How to test:
         * ============
         * Simply (un)comment the 'default-image' to see the difference
         * in "Header Image" section of customizer.
         * But do not save/publish your customizer as we are testing
         * how the theme code is treated in customizer!
        add_theme_support( 'custom-header', array(
                // 'default-image' => '',
                'random-default' => true,

                // Irrelevant, but required options:
                'height' => 200,
                'width'  => 1000,
        ) );

        // Registering some images to randomize from:
        register_default_headers( array(
                'image-1' => array(
                        'url'           => '',
                        'thumbnail_url' => '',
                        'description'   => 'Image 1',
                'image-2' => array(
                        'url'           => '',
                        'thumbnail_url' => '',
                        'description'   => 'Image 2',
        ) );

add_action( 'after_setup_theme', 'test_custom_header_hide_button' );
// Display the custom header in theme footer for preview:
add_action( 'wp_footer', 'the_custom_header_markup' );


Preview of the issue with custom header registration in customizer

Attachments (2)

custom-header-setup-via-theme.png (23.5 KB) - added by webmandesign 5 years ago.
Preview of the issue with custom header registration in customizer
46128.diff (1.2 KB) - added by dlh 4 years ago.

Download all attachments as: .zip

Change History (3)

5 years ago

Preview of the issue with custom header registration in customizer

4 years ago

#1 @dlh
4 years ago

  • Focuses ui removed
  • Keywords has-patch needs-testing added
  • Version changed from 5.0.3 to 3.4

Hi @webmandesign, and (belated) thanks for this report.

The custom header API is far from my expertise. But, by my reckoning, the default for the header_image setting needs to be modified so that it returns random-default-image when random header images are going to be used. 46128.diff has that change. Would you be able to test the patch?

From my reading of the code and testing, the patch should respect themes that set random-image to false.

I don't think there needs to be a case where the default is random-uploaded-image, because is_random_header_image() won't return an uploaded image as a fallback, but my unfamiliarity could be misleading me about this point.

Note: See TracTickets for help on using tickets.