Thumbnails

This website contains links to software which is either no longer maintained or will be supported only until the end of 2019 (CKFinder 2). For the latest documentation about current CKSource projects, including software like CKEditor 4/CKEditor 5, CKFinder 3, Cloud Services, Letters, Accessibility Checker, please visit the new documentation website.

If you look for an information about very old versions of CKEditor, FCKeditor and CKFinder check also the CKEditor forum, which was closed in 2015. If not, please head to StackOverflow for support.

You can set thumbnails parameters by changing the following values:

config.thumbnails = structNew();
config.thumbnails.url = config.baseUrl & '_thumbs';
config.thumbnails.baseDir = "";
config.thumbnails.enabled = true;
config.thumbnails.maxWidth = 200;
config.thumbnails.maxHeight = 200;
config.thumbnails.quality = 80;
  • maxWidth and maxHeight determines the maximum size of the thumbnails which can appear in CKFinder. These values are expressed in pixels. Of course you can increase them but than the thumbnails will look more like the full-sized images rather than miniatures.
  • quality sets the quality of the thumbnail in a range from 1 to 100. The smaller the quality the smaller the size of the thumbnails. Notice that an acceptable value of the quality is about 45 and the mostly used is about 80.
  • directAccess is a setting that may increase the overall performance of CKFinder. By default, CKFinder connects to the server connector to get the thumbnail. It is not a problem in most cases, because the connector sends the "HTTP/304 Not Modified" header most of the time to save the traffic and reduce server side processing. However, sometimes it is better to leave cache control to the browser. When directAccess is set to true, thumbnails are loaded directly from the "_thumbs" folder by CKFinder. Note that it is impossible to use this setting if directory with thumbnails resides outside the document root.


  • You may disable the thumbnails by placing the bool value false in the enabled section.
This page was last edited on 28 May 2010, at 07:46.