the_post_thumbnail() WordPress Function
The the_post_thumbnail() function is used to display the featured image for a post. The function can be used with or without arguments. When used with no arguments, the function will display the featured image for the current post. The function can also be used with arguments to display the featured image for a specific post.
the_post_thumbnail( string|int[] $size = 'post-thumbnail', string|array $attr = '' ) #
Displays the post thumbnail.
Description
When a theme adds ‘post-thumbnail’ support, a special ‘post-thumbnail’ image size is registered, which differs from the ‘thumbnail’ image size managed via the Settings > Media screen.
When using the_post_thumbnail() or related functions, the ‘post-thumbnail’ image size is used by default, though a different size can be specified instead as needed.
See also
Parameters
- $size
(string|int[])(Optional) Image size. Accepts any registered image size name, or an array of width and height values in pixels (in that order).
Default value: 'post-thumbnail'
- $attr
(string|array)(Optional) Query string or array of attributes.
Default value: ''
Source
File: wp-includes/post-thumbnail-template.php
function the_post_thumbnail( $size = 'post-thumbnail', $attr = '' ) {
echo get_the_post_thumbnail( null, $size, $attr );
}
Expand full source codeCollapse full source codeView on TracView on GitHub
Changelog
| Version | Description |
|---|---|
| 2.9.0 | Introduced. |