apply_filters( 'big_image_size_threshold', int $threshold, array $imagesize, string $file, int $attachment_id )

Filters the “BIG image” threshold value.


Description Description

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.


Top ↑

Parameters Parameters

$threshold

(int) The threshold value in pixels. Default 2560.

$imagesize

(array) Indexed array of the image width and height in pixels.

  • (int) The image width.
  • '1'
    (int) The image height.

$file

(string) Full path to the uploaded image file.

$attachment_id

(int) Attachment post ID.


Top ↑

Source Source

File: wp-admin/includes/image.php

View on Trac



Top ↑

Changelog Changelog

Changelog
Version Description
5.3.0 Introduced.

Top ↑

User Contributed Notes User Contributed Notes

  1. Skip to note 1 content
    Contributed by squarecandy

    Usage examples:

    // completely disable image size threshold
    add_filter( 'big_image_size_threshold', '__return_false' );
    
    // increase the image size threshold to 4000px
    function mynamespace_big_image_size_threshold( $threshold ) {
    	return 4000; // new threshold
    }
    add_filter('big_image_size_threshold', 'mynamespace_big_image_size_threshold', 999, 1);
    

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