thumbs

Presets

You can define option presets for thumbs:

return [
    'thumbs' => [
        'presets' => [
            'default' => ['width' => 1024, 'quality' => 80],
            'blurred' => ['blur' => true]
        ]
    ]
];

To be used with the $file->thumb() method. Learn more ›

Srcsets

return [
  'thumbs' => [
    'srcsets' => [
      'default' => [
        '800w' => ['width' => 800, 'quality' => 80],
        '1024w' => ['width' => 1024, 'quality' => 80],
        '1440w' => ['width' => 1440, 'quality' => 80],
        '2048w' => ['width' => 2048, 'quality' => 80]
      ]
  ]
  ]
];

To be used with the $file->srcset() method. Learn more ›

Auto-orient

Automatically rotate images based on their exif orientation data.

return [
  'thumbs' => [
    'autoOrient' => true
  ]
];

Quality

The default compression quality for all thumbnails

return [
  'thumbs' => [
    'quality' => 80
  ]
];

Depending on your thumbnail driver, this is supported for JPG, WEBP and AVIF images (gd driver) or JPEG, PNG, HEIC, AVIF and WebP images (im driver).

Format

You can set a default format for thumbs in your config file to convert all images unless you override the format option in the thumb method.

<?php

return [
  'thumbs' => [
    'format' => 'webp'
  ]
];

This is only recommended if you really find yourself converting 90% of your files to that format anyway. Otherwise you will need to override the default quite a lot.

Thumbs driver

Kirby comes with drivers for GD Lib (gd) and Imagick (imagick, since v5.1.0), which can be used out of the box. The default thumbs driver is gd.

You can also define your own custom thumbs drivers.

return [
  'thumbs' => [
    'driver' => 'imagick'
  ]
];

return [
  'thumbs' => [
    'driver'    => 'imagick',
    'interlace' => true
  ]
];

return [
  'thumbs' => [
    'driver'   => 'imagick',
    'profiles' => ['icc']
  ]
];

return [
  'thumbs' => [
    'driver' => 'imagick',
    'threads' => 2
  ]
];

Additional options for the ImageMagick driver

All of the above options for the Imagick driver as well as:

bin

If the ImageMagick convert binary is not correctly linked, you can set the absolute path to the binary here.

return [
  'thumbs' => [
    'driver' => 'im',
    'bin'    => 'convert'
  ]
];