Manual:$wgImageLimits

Images: $wgImageLimits
A list of user-selectable limits for the image thumbnail size on image description pages.
Introduced in version:	1.4.0
Removed in version:	Still in use
Allowed values:	see below
Default value:	see below
Other settings: Alphabetical | By function

Details

This variable contains an array of 2-element arrays. Each of these defines a width/height pair describing a maximum image size (in pixels). The image sizes defined in this variable are used on the user preference page to allow the user to specify an image size-limit when viewing image pages. In order to reduce the amount of disk space taken up by thumbnails of many different sizes, limits can only be selected from this list.

This setting also determines the list of thumbnail links which are provided on the image page, just below the image.

This setting relates to images as shown on image description pages (File: namespace). For thumbnails in articles and other wiki pages, see $wgThumbLimits .

Default values

MediaWiki version:

≥ 1.36 Gerrit change 682645

$wgImageLimits = [
	[ 320, 240 ],
	[ 640, 480 ],
	[ 800, 600 ],
	[ 1024, 768 ],
	[ 1280, 1024 ],
	[ 2560, 2048 ],
];

MediaWiki versions:

1.20 – 1.35

$wgImageLimits = [
	[ 320, 240 ],
	[ 640, 480 ],
	[ 800, 600 ],
	[ 1024, 768 ],
	[ 1280, 1024 ]
];

MediaWiki versions:

1.4 – 1.19

$wgImageLimits = array(
	array( 320, 240 ),
	array( 640, 480 ),
	array( 800, 600 ),
	array( 1024, 768 ),
	array( 1280, 1024 ),
	array( 10000, 10000 )
);

Example

If you are using a skin which has a fixed width for page content, you will probably want to make the maximum size equal to that width. Put these settings in your LocalSettings.php :

// Don't allow larger image sizes because they will ruin the page format
$wgImageLimits = [
   [ 320, 240 ], // image size 0
   [ 500, 375 ]  // image size 1
];

If you change this array, you also want to change the default user option for image sizes on image pages. Each image size set is automatically associated with an integer value that may be used for the imagesize user option. This value always starts with "0" for the lowest image size set in the array and increases by 1 per additional image size defined, e.g. if five different image sizes were set the lowest value for the user option is "0" while "4" is the highest.

// By default display the larger option
$wgDefaultUserOptions['imagesize'] = 1; // image size 500, 375

See also

• Manual:$wgThumbLimits
• Manual:$wgThumbnailBuckets