set_post_thumbnail_size( int $width, int $height, bool|array $crop = false )

User Contributed Notes

1. Skip to note 4 content

   Codex 9 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 2You must log in to vote on the helpfulness of this note

   Default Usage
   To be used in the current theme’s functions.php file.

   function wpdocs_setup_theme() {
   	add_theme_support( 'post-thumbnails' );
   	set_post_thumbnail_size( 150, 150 );
   }
   add_action( 'after_setup_theme', 'wpdocs_setup_theme' );
2. Skip to note 5 content

   Codex 9 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 1You must log in to vote on the helpfulness of this note

   Crop Mode
   Set the default Post Thumbnail size by resizing the image proportionally (that is, without distorting it):

   set_post_thumbnail_size( 50, 50 ); // 50 pixels wide by 50 pixels tall, resize mode

   Set the default Post Thumbnail size by cropping the image (either from the sides, or from the top and bottom):

   set_post_thumbnail_size( 50, 50, true ); // 50 pixels wide by 50 pixels tall, crop mode

   Set the default Post Thumbnail size by cropping the image from top left:

   set_post_thumbnail_size( 50, 50, array( 'top', 'left')  ); // 50 pixels wide by 50 pixels tall, crop from the top left corner

   Set the default Post Thumbnail size by cropping the image from the center:

   set_post_thumbnail_size( 50, 50, array( 'center', 'center')  ); // 50 pixels wide by 50 pixels tall, crop 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.
3. Skip to note 6 content

   Gabor Lippert 1 year ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 1You must log in to vote on the helpfulness of this note

   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.

   function wpdocs_mac_setup_theme() {
   	add_theme_support( 'post-thumbnails' );
   	set_post_thumbnail_size( 280, 153, false );
   }
   add_action( 'after_setup_theme', 'wpdocs_mac_setup_theme' );