set_post_thumbnail_size( int $width, int $height, bool|array $crop = false )
Registers an image size for the post thumbnail.
Contents
Description
See also
- add_image_size() : for details on cropping behavior.
Parameters
-
$width
int Required -
Image width in pixels.
-
$height
int Required -
Image height in pixels.
-
$crop
bool|array Optional -
Whether to crop images to specified width and height or resize.
An array can specify positioning of the crop area.Default:
false
More Information
- To register additional image sizes for Featured Images use: add_image_size() .
- To enable featured images, the current theme must include
add_theme_support( 'post-thumbnails' );
in its functions.php file. See also Post Thumbnails. - This function will not resize your existing featured images. To regenerate existing images in the new size, use the Regenerate Thumbnails plugin.
Source
File: wp-includes/media.php
.
View all references
function set_post_thumbnail_size( $width = 0, $height = 0, $crop = false ) {
add_image_size( 'post-thumbnail', $width, $height, $crop );
}
Changelog
Version | Description |
---|---|
2.9.0 | Introduced. |
User Contributed Notes
You must log in before being able to contribute a note or feedback.
Default Usage
To be used in the current theme’s
functions.php
file.Crop Mode
Set the default Post Thumbnail size by resizing the image proportionally (that is, without distorting it):
Set the default Post Thumbnail size by cropping the image (either from the sides, or from the top and bottom):
Set the default Post Thumbnail size by cropping the image from top left:
Set the default Post Thumbnail size by cropping the image from the center:
Note:
This function will not resize your existing featured images. To regenerate existing images in the new size, use the Regenerate Thumbnails plugin.
I guess this just stopped working in the new Gutenberg editor environment. ¯\_(ツ)_/¯
At least with the below, totally standard usage, the function doesn’t have any effect on the way a post thumbnail gets displayed on a post edit screen.