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

Filters the “BIG image” threshold value.

Contents

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

$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

File: wp-admin/includes/image.php. View all references 

$threshold = (int) apply_filters( 'big_image_size_threshold', 2560, $imagesize, $file, $attachment_id );

View on Trac View on GitHub

Top ↑

Top ↑

Used By

Used By
Used By Description
wp_create_image_subsizes() wp-admin/includes/image.php

Creates image sub-sizes, adds the new data to the image meta sizes array, and updates the image metadata.

Top ↑

Changelog

Changelog
Version Description
5.3.0 Introduced.

Top ↑

User Contributed Notes

  1. Skip to note 1 content
    You must log in to vote on the helpfulness of this noteVote results for this note: 4You must log in to vote on the helpfulness of this note
    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.