image_size_names_choose filter-hookWP 3.3.0

Filters the names and labels of the default image sizes.

Usage

add_filter( 'image_size_names_choose', 'wp_kama_image_size_names_choose_filter' );

/**
 * Function for `image_size_names_choose` filter-hook.
 * 
 * @param string[] $size_names Array of image size labels keyed by their name.
 *
 * @return string[]
 */
function wp_kama_image_size_names_choose_filter( $size_names ){

	// filter...
	return $size_names;
}
$size_names(string[])
Array of image size labels keyed by their name.
Default: values include 'Thumbnail', 'Medium', 'Large', and 'Full Size'

Changelog

Since 3.3.0 Introduced.

Where the hook is called

image_size_input_fields()
image_size_names_choose
get_default_block_editor_settings()
image_size_names_choose
wp_print_media_templates()
image_size_names_choose
wp_prepare_attachment_for_js()
image_size_names_choose
Custom_Background::wp_set_background_image()
image_size_names_choose
wp-admin/includes/media.php 1188-1196
$size_names = apply_filters(
	'image_size_names_choose',
	array(
		'thumbnail' => __( 'Thumbnail' ),
		'medium'    => __( 'Medium' ),
		'large'     => __( 'Large' ),
		'full'      => __( 'Full Size' ),
	)
);
wp-includes/block-editor.php 167-175
$image_size_names = apply_filters(
	'image_size_names_choose',
	array(
		'thumbnail' => __( 'Thumbnail' ),
		'medium'    => __( 'Medium' ),
		'large'     => __( 'Large' ),
		'full'      => __( 'Full Size' ),
	)
);
wp-includes/media-template.php 855-863
$sizes = apply_filters(
	'image_size_names_choose',
	array(
		'thumbnail' => __( 'Thumbnail' ),
		'medium'    => __( 'Medium' ),
		'large'     => __( 'Large' ),
		'full'      => __( 'Full Size' ),
	)
);
wp-includes/media-template.php 935-943
$size_names = apply_filters(
	'image_size_names_choose',
	array(
		'thumbnail' => __( 'Thumbnail' ),
		'medium'    => __( 'Medium' ),
		'large'     => __( 'Large' ),
		'full'      => __( 'Full Size' ),
	)
);
wp-includes/media-template.php 1126-1134
$sizes = apply_filters(
	'image_size_names_choose',
	array(
		'thumbnail' => __( 'Thumbnail' ),
		'medium'    => __( 'Medium' ),
		'large'     => __( 'Large' ),
		'full'      => __( 'Full Size' ),
	)
);
wp-includes/media.php 4205-4213
$possible_sizes = apply_filters(
	'image_size_names_choose',
	array(
		'thumbnail' => __( 'Thumbnail' ),
		'medium'    => __( 'Medium' ),
		'large'     => __( 'Large' ),
		'full'      => __( 'Full Size' ),
	)
);
wp-admin/includes/class-custom-background.php 602-610
apply_filters(
	'image_size_names_choose',
	array(
		'thumbnail' => __( 'Thumbnail' ),
		'medium'    => __( 'Medium' ),
		'large'     => __( 'Large' ),
		'full'      => __( 'Full Size' ),
	)
)

Where the hook is used in WordPress

wp-admin/includes/ajax-actions.php 3978
add_filter( 'image_size_names_choose', array( $wp_site_icon, 'additional_sizes' ) );
wp-admin/includes/ajax-actions.php 3993
add_filter( 'image_size_names_choose', array( $wp_site_icon, 'additional_sizes' ) );