Filter hook 'big_image_size_threshold'

in WP Core File wp-admin/includes/image.php at line 285

View Source

big_image_size_threshold

Filter Hook
Description
Filters the "BIG image" threshold value. If the original image width or height is above the threshold, it will be scaled down. The threshold is used as max width and max height. The scaled down image will be used as the largest available size, including the `_wp_attached_file` post meta value. Returning `false` from the filter callback will disable the scaling. }

Hook Information

File Location wp-admin/includes/image.php View on GitHub
Hook Type Filter
Line Number 285

Hook Parameters

Type Name Description
int $threshold The threshold value in pixels. Default 2560.
array $imagesize { Indexed array of the image width and height in pixels.
string $file Full path to the uploaded image file.
int $attachment_id Attachment post ID.

Usage Examples

Basic Usage
<?php
// Hook into big_image_size_threshold
add_filter('big_image_size_threshold', 'my_custom_filter', 10, 4);

function my_custom_filter($threshold, $imagesize, $file, $attachment_id) {
    // Your custom filtering logic here
    return $threshold;
}

Source Code Context

wp-admin/includes/image.php:285 - How this hook is used in WordPress core
<?php
 280  	 *     @type int $1 The image height.
 281  	 * }
 282  	 * @param string $file          Full path to the uploaded image file.
 283  	 * @param int    $attachment_id Attachment post ID.
 284  	 */
 285  	$threshold = (int) apply_filters( 'big_image_size_threshold', 2560, $imagesize, $file, $attachment_id );
 286  
 287  	/*
 288  	 * If the original image's dimensions are over the threshold,
 289  	 * scale the image and use it as the "full" size.
 290  	 */

PHP Documentation

<?php
/**
	 * Filters the "BIG image" threshold value.
	 *
	 * If the original image width or height is above the threshold, it will be scaled down. The threshold is
	 * used as max width and max height. The scaled down image will be used as the largest available size, including
	 * the `_wp_attached_file` post meta value.
	 *
	 * Returning `false` from the filter callback will disable the scaling.
	 *
	 * @since 5.3.0
	 *
	 * @param int    $threshold     The threshold value in pixels. Default 2560.
	 * @param array  $imagesize     {
	 *     Indexed array of the image width and height in pixels.
	 *
	 *     @type int $0 The image width.
	 *     @type int $1 The image height.
	 * }
	 * @param string $file          Full path to the uploaded image file.
	 * @param int    $attachment_id Attachment post ID.
	 */
Quick Info
  • Hook Type: Filter
  • Parameters: 4
  • File: wp-admin/includes/image.php
Related Hooks

Related hooks will be displayed here in future updates.