How to Get the Featured Image URL in WordPress: 5 Tested Ways

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(), 'large' );

I first wrote this guide in 2018, and back then I told you to use 'full'. That advice has aged badly.

This time I ran every snippet below on a fresh WordPress 7.1.2 site, with a real 4032 × 2688 photo (the size a phone camera takes) set as the featured image. Two results surprised me, and they change which line you should copy.

What does each function actually return?

Most guides copy the function signatures from the docs. I wanted to see the real output, so I built a small test site in WordPress Playground with the default Twenty Twenty-Five theme and printed what every call returned.

Surprise one: 'full' is not your original upload. Since WordPress 5.3, any image wider or taller than 2,560 pixels is scaled down on upload. That -scaled copy becomes "full". The original is kept, but no size name gives it to you.

Surprise two: a misspelt size name fails silently. Ask for 'lage' and WordPress hands back the biggest file it has, with no warning. The same happens when you leave the size out: the default name, post-thumbnail, is not registered by Twenty Twenty-Five, so it falls back to full too.

Which image size should you ask for?

The size name decides how many kilobytes every visitor downloads. I weighed every file WordPress made from my test photo.

My default is large. It is wide enough for a normal content column, at about a fifth of the weight of full. Your theme can add its own sizes with add_image_size( 'hero', 1920, 600, true ). Ask for them by name, and spell the name right.

Serving oversized featured images is one of the most common, and most fixable, drags on WordPress site speed. Compressing the files themselves is a separate job, covered in my guide to optimising images in WordPress.

Does your theme support featured images?

The functions below only return something if the active theme supports featured images. Every modern theme does, including all the default block themes.

If get_the_post_thumbnail_url() keeps returning false even on posts with an image, 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 have something to read.

If your problem is the opposite, 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 everyday one

Best for: 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 a size name, and returns the URL as a 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(), 'large' );
    echo esc_url( $featured_url );
}

Always pass a size. As my test showed, leaving it out gave me the 2,560px file on a block theme.

Using it as a CSS background

The most common reason to want the URL rather than the image tag is 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; ?>

One catch with backgrounds: a CSS background cannot use srcset to pick a smaller file on mobile, and the browser finds it later than an <img> tag. If the hero is your largest element, an <img> tag with srcset usually loads faster. That hurts or helps your Core Web Vitals more than any other choice here.

$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() );
$original_url = wp_get_original_image_url( $thumbnail_id );

if ( $original_url ) {
    echo esc_url( $original_url );
}

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

if ( $thumbnail_id ) {
    $image_url = wp_get_attachment_image_url( $thumbnail_id, 'large' );
    echo esc_url( $image_url );
}

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

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

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

How do you get the featured image URL by post ID?

The snippets that use get_the_ID() only work inside the loop. That is the mistake I see most often. Outside it, in a widget, a plugin or a custom query, 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 them 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( get_post_meta( get_post_thumbnail_id( $post->ID ), '_wp_attachment_image_alt', true ) ) . '">';
    }
}

How do you get the featured image alt text and caption?

A URL on its own is only half an image. For the alt attribute and the caption, these two calls returned exactly what I typed in the Media Library:

$thumb_id = get_post_thumbnail_id( get_the_ID() );

$alt     = get_post_meta( $thumb_id, '_wp_attachment_image_alt', true );
$caption = get_the_post_thumbnail_caption( get_the_ID() );

In my test, $alt came back as "Mountain range at sunrise" and the caption as the text I saved on the attachment. If the alt field is empty, fall back to the post title rather than printing an empty alt.

What if a post has no featured image?

Every method above returns false, 0 or an empty string when there is no image. I checked all three on an image-less post. On a real site, some posts always slip through without one, so plan for 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 );
}

Call tgx_featured_or_fallback() anywhere, and you never print an empty src again.

Does this work in block themes?

Yes. I ran every PHP snippet here with Twenty Twenty-Five active, and they all behaved as shown. Use them in a plugin, a custom block, or a child theme's functions.php.

If you only need the image on the page, you may not need code at all. The Post Featured Image block shows it in any template. The Cover block can use the post's featured image as its background, which covers the classic hero-with-text layout.

The code route still matters for things blocks do not cover: Open Graph tags, JSON feeds, emails, and headless front ends.

Can you get the URL without code?

If you only need the URL once, skip the PHP. Open Media → Library, click the image, and copy the File URL from the details panel, as in my screenshot above. Remember it will be the -scaled copy for big uploads.

For a published page, right-click the featured image and choose "Copy image address". That gives you whichever size the theme rendered, which is often not the one you expect.

Which method should you use?

For nine cases out of ten: get_the_post_thumbnail_url( $id, 'large' ), wrapped in has_post_thumbnail().

Reach for wp_get_attachment_image_src() when you need width and height, wp_get_original_image_url() only when you truly need the untouched upload, and the REST API with _embed=wp:featuredmedia on headless sites. Add the fallback helper on any site where some posts will not have an image.

Final take

The featured image URL is still one line of PHP. The line I recommend has just changed: ask for 'large', not 'full'.

My test made the reason plain. On a modern WordPress site, "full" is a 2,560px scaled copy weighing five times more than "large". A typo in the size name hands you that same heavy file without a word.

Check the image exists, name the size on purpose, and spell it right. Those three habits prevent the broken layouts and slow pages that the one-liner alone can quietly cause.