How to test if a custom header image is used in WordPress

- by

You can use a handy function named get_header_image() for this. It will return the image uploaded by a user, or an empty string if a custom header image is not used.

You can base decisions on this query:

if (get_header_image() == '') {
    // if no header image is present, do this
} else {
    // if we have a header image, do something else
}

Note that get_header_image() is not a boolean function, so testing like this won’t work:

if (get_header_image()) {
    // this is not going to work
}

Find more details in the WordPress Codex:



If you enjoy my content, please consider supporting me on Ko-fi. In return you can browse this whole site witout any pesky ads! More details here.

Add your voice!

This site uses Akismet to reduce spam. Learn how your comment data is processed.