get_the_post_thumbnail


get_the_post_thumbnail ( $post = null, $size = 'post-thumbnail', $attr = '' )

Parameters:
  • (int|WP_Post) $post Optional. Post ID or WP_Post object. Default is global `$post`.
  • (string|array) $size Optional. Image size to use. Accepts any valid image size, or an array of width and height values in pixels (in that order). Default 'post-thumbnail'.
  • (string|array) $attr Optional. Query string or array of attributes. Default empty.
Returns:
  • (string) The post thumbnail image tag.
Defined at:
Change Log:
  • 4: .

Description

Retrieve the post thumbnail.

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.

Related Functions

get_the_post_thumbnail_url, the_post_thumbnail, get_the_post_thumbnail_caption, set_post_thumbnail, get_post_thumbnail_id

Top Google Results

User discussions

wpseek mobile