wp_get_attachment_image_sizes( int $attachment_id, string|int[] $size = 'medium', array $image_meta = null ): string|false

Retrieves the value for an image attachment’s ‘sizes’ attribute.


Top ↑

See also

Top ↑


$attachment_id int Required
Image attachment ID.
$size string|int[] Optional
Image size. Accepts any registered image size name, or an array of width and height values in pixels (in that order). Default 'medium'.

Default: 'medium'

$image_meta array Optional
The image meta data as returned by 'wp_get_attachment_metadata() '.

Default: null

Top ↑


string|false A valid source size value for use in a 'sizes' attribute or false.

Top ↑


File: wp-includes/media.php. View all references

function wp_get_attachment_image_sizes( $attachment_id, $size = 'medium', $image_meta = null ) {
	$image = wp_get_attachment_image_src( $attachment_id, $size );

	if ( ! $image ) {
		return false;

	if ( ! is_array( $image_meta ) ) {
		$image_meta = wp_get_attachment_metadata( $attachment_id );

	$image_src  = $image[0];
	$size_array = array(
		absint( $image[1] ),
		absint( $image[2] ),

	return wp_calculate_image_sizes( $size_array, $image_src, $image_meta, $attachment_id );

Top ↑


Version Description
4.4.0 Introduced.

Top ↑

User Contributed Notes

You must log in before being able to contribute a note or feedback.