Summery Summery

Register a new image size.

Syntax Syntax

add_image_size( string $name, int $width, int $height, bool|array $crop = false )

Parameters Parameters


(Required) Image size identifier.


(Optional) Image width in pixels. Default 0.


(Optional) Image height in pixels. Default 0.


(Optional) Image cropping behavior. If false, the image will be scaled (default), If true, image will be cropped to the specified dimensions using center positions. If an array, the image will be cropped using the array to specify the crop location. Array values must be in the format: array( x_crop_position, y_crop_position ) where: - x_crop_position accepts: 'left', 'center', or 'right'. - y_crop_position accepts: 'top', 'center', or 'bottom'.

Default value: false

Source Source

File: wp-includes/media.php

function add_image_size( $name, $width = 0, $height = 0, $crop = false ) {
	global $_wp_additional_image_sizes;

	$_wp_additional_image_sizes[ $name ] = array(
		'width'  => absint( $width ),
		'height' => absint( $height ),
		'crop'   => $crop,


Changelog Changelog

Version Description
2.9.0 Introduced.


Leave a Reply