On this page
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
$sizestring|int[] Optional-
Image size. Accepts any registered image size name, or an array of width and height values in pixels (in that order). Default
'post-thumbnail'.Default:
'post-thumbnail' $attrstring|array Optional-
Query string or array of attributes.
Default:
''
Source
File: wp-includes/post-thumbnail-template.php. View all references
function the_post_thumbnail( $size = 'post-thumbnail', $attr = '' ) {
echo get_the_post_thumbnail( null, $size, $attr );
}
Related
Uses
| Uses | Description |
|---|---|
| get_the_post_thumbnail() wp-includes/post-thumbnail-template.php | Retrieves the post thumbnail. |
Changelog
| Version | Description |
|---|---|
| 2.9.0 | Introduced. |
© 2003–2022 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/functions/the_post_thumbnail