How to Get the Featured Image URL in WordPress (5 Ways + REST API)

You came for one line of code. Here it is.

Inside the loop, this returns the featured image URL as a string:

$url = get_the_post_thumbnail_url( get_the_ID(), 'full' );

That one line covers about nine cases out of ten.

The rest of this guide is the variations you reach for when your case is the tenth: when you also need the width and height, when the site is headless and you are pulling the URL in JavaScript, and when a post has no image at all and you cannot let that break the page.

Every snippet below is current WordPress core. No plugin, nothing to install, and each function links to its official reference.

First, make sure the theme supports featured images

Featured images only exist if the active theme has declared support for them. Almost every modern theme does.

But if get_the_post_thumbnail_url() keeps returning nothing, this is the first thing I check.

Add this to your theme's functions.php, inside an after_setup_theme hook:

add_theme_support( 'post-thumbnails' );

With that in place, the "Featured image" panel appears in the editor and the functions below have something to return.

And if your problem is the reverse, the theme printing the image where you do not want it, I have covered hiding the featured image separately.

Method 1

01

get_the_post_thumbnail_url(): the simple one

Best for: The everyday case: you want the URL and nothing else.

This is the function to reach for first. get_the_post_thumbnail_url() takes a post ID and an image size, and returns the URL as a plain string, or false if the post has no featured image.

php

if ( has_post_thumbnail() ) {
    $featured_url = get_the_post_thumbnail_url( get_the_ID(), 'full' );
    echo esc_url( $featured_url );
}

The has_post_thumbnail() check matters. Without it, a post with no image returns false, and you end up printing an empty src or a broken background.

Using it as a CSS background

A common reason to want the URL rather than the image tag is to set a hero background:

php

<?php if ( has_post_thumbnail() ) : ?>
    <div class="hero" style="background-image: url('<?php echo esc_url( get_the_post_thumbnail_url( get_the_ID(), 'large' ) ); ?>');">
        <h1><?php the_title(); ?></h1>
    </div>
<?php endif; ?>

Note the size is large, not full. A hero rarely needs the original file, and serving a 4000px image as a background is a quick way to wreck your Core Web Vitals. Compressing and sizing the files themselves is a separate job, covered in my guide to optimizing images in WordPress.

$thumbnail_id = get_post_thumbnail_id( get_the_ID() );
$image        = wp_get_attachment_image_src( $thumbnail_id, 'large' );

if ( $image ) {
    $url    = $image[0]; // the URL
    $width  = $image[1]; // width in pixels
    $height = $image[2]; // height in pixels
}

function tgx_og_image_tags() {
    if ( is_singular() && has_post_thumbnail() ) {
        $img = wp_get_attachment_image_src( get_post_thumbnail_id(), 'large' );
        if ( $img ) {
            printf( '<meta property="og:image" content="%s">' . "\n", esc_url( $img[0] ) );
            printf( '<meta property="og:image:width" content="%s">' . "\n", esc_attr( $img[1] ) );
            printf( '<meta property="og:image:height" content="%s">' . "\n", esc_attr( $img[2] ) );
        }
    }
}
add_action( 'wp_head', 'tgx_og_image_tags' );

$thumbnail_id = get_post_thumbnail_id( get_the_ID() );
$image_url    = wp_get_attachment_image_url( $thumbnail_id, 'large' );

if ( $image_url ) {
    echo '<img src="' . esc_url( $image_url ) . '" alt="' . esc_attr( get_the_title() ) . '">';
}

$thumbnail_id = get_post_meta( get_the_ID(), '_thumbnail_id', true );

if ( $thumbnail_id ) {
    $image_url = wp_get_attachment_url( $thumbnail_id );
    echo esc_url( $image_url );
}

async function getFeaturedImageUrl( postId ) {
  const res  = await fetch(
    `https://yoursite.com/wp-json/wp/v2/posts/${postId}?_embed`
  )
  const post = await res.json()

  const media = post._embedded?.['wp:featuredmedia']?.[0]
  if ( ! media ) return null

  return {
    full:   media.source_url,
    medium: media.media_details?.sizes?.medium?.source_url,
  }
}

Getting the featured image URL by post ID (outside the loop)

Here is the mistake I see most often: the snippets that use get_the_ID() only work inside the loop. Outside it, in a widget, a sidebar, or a custom query, just pass the post ID directly.

// Featured image URL for post 42, from anywhere
$url = get_the_post_thumbnail_url( 42, 'large' );

For a list of posts, loop over the IDs and call it for each:

$recent = get_posts( array( 'numberposts' => 5 ) );

foreach ( $recent as $post ) {
    $img = get_the_post_thumbnail_url( $post->ID, 'medium' );
    if ( $img ) {
        echo '<img src="' . esc_url( $img ) . '" alt="' . esc_attr( $post->post_title ) . '">';
    }
}

Handling a post with no featured image

Every method above returns false or nothing when there is no image. And on a real site, some posts always slip through without one. Plan for it, do not hope around it.

The cleanest pattern is a small helper that falls back to a default image in your theme:

function tgx_featured_or_fallback( $post_id = null, $size = 'large' ) {
    $url = get_the_post_thumbnail_url( $post_id, $size );

    if ( ! $url ) {
        $url = get_template_directory_uri() . '/assets/default-featured.jpg';
    }

    return esc_url( $url );
}

Now you can call tgx_featured_or_fallback() anywhere and never worry about an empty src again.

Getting the URL without code

If you only need the URL once, you do not have to touch any PHP. Open the post in the editor, click the featured image, and the media panel shows the file URL on the right, ready to copy.

For a published page, open it in your browser, right-click the featured image, and choose "Copy image address". That is the live URL of whatever size the theme rendered. It is the fastest route when you just want to paste one image link somewhere, not build it into a template.

A quick note on image sizes

Every method takes a size name, and picking the right one is the difference between a fast page and a slow one. These are the defaults:

Request the smallest size that still looks right. You can register your own with add_image_size( 'hero', 1920, 600, true ) and ask for it by name. Serving oversized featured images is one of the most common, and most fixable, drags on WordPress site speed.

Which method should you use?

For nine cases out of ten, Method 1 is the answer: get_the_post_thumbnail_url(), wrapped in has_post_thumbnail().

Reach for Method 2 when you need width and height, the REST API method when the front end is headless or JavaScript, and the fallback helper on any site where some posts will not have an image. The meta route in Method 4 is good to understand but rarely the one you actually pick.

Final take

The featured image URL is one line of PHP for almost everyone: get_the_post_thumbnail_url( get_the_ID(), 'full' ).

Everything else here is for the edges, dimensions, headless, and missing images, that turn a quick snippet into something that holds up on a real site.

Always check the image exists before you print it, and always request a sensible size. Those two habits prevent the broken layouts and slow pages that the one-liner alone can quietly cause.