If you’ve ever built a WordPress theme, you’ve probably faced this issue: a client or user wants to upload their own logo, but your theme only supports a site title. The solution is simpler than you might think!

WordPress has a built-in feature called add_theme_support that makes adding a custom logo uploader a breeze. Let’s walk through the two simple steps.

Step 1: Add Theme Support in functions.php

First, you need to tell WordPress that your theme supports a custom logo. We do this by adding a single line of code to our theme’s functions.php file.

Open your functions.php file and add the following code:

<?php
// Add custom logo support
function my_theme_setup() {
    add_theme_support( 'custom-logo' );
}
add_action( 'after_setup_theme', 'my_theme_setup' );
?>

This code hooks into WordPress’s initialization process and declares that your theme can use the custom logo feature.

Step 2: Display the Logo in Your Theme

Now that WordPress knows your theme supports a logo, you need to display it. This is done in your header.php file, wherever you want the logo to appear (usually where your site title currently is).

Find the spot in your header.php where you want the logo and add this simple function:

<?php
// Display the custom logo
if ( has_custom_logo() ) {
    the_custom_logo();
} else {
    echo '<h1>'. get_bloginfo( 'name' ) .'</h1>';
}
?>

This code is smart—it first checks if a logo has been uploaded. If it has, it displays the logo. If not, it falls back to displaying the site title.

You’re Done!

That’s all there is to it! Now, when you go to Appearance > Customize in your WordPress dashboard, you’ll see a new “Logo” option where you can upload an image.

This simple addition makes your themes much more professional and user-friendly. No more editing code just to change a logo!