Settings - Files

You can access these settings in the Settings application under the System -> Files category.

Storage

Store files in

Select where you want the system to store files (attachments, attachment history, CMS.File pages).

  • Database
  • File system
  • Database and file system

Generate thumbnails

Indicates if the Kentico should generate image thumbnails on the disk when a resized version of the image is displayed. This option only applies if files are stored in the file system. It improves site performance.

Files folder

The folder on the disk where page attachments and metafiles are stored. You can use:

  • physical disk path: e.g. c:\myfiles\
  • virtual path: ~/UploadedFiles
  • UNC path: \\server\folder

If you do not specify any value, the files are stored in the default folder: ~/<site code name>/files

Attachments of pages under workflow (i.e., attachment histories) are stored in the ~/App_Data/VersionHistory/Attachments folder regardless of the Files folder setting.

Note: When you change the file folder location, the system does NOT automatically move existing files to the new location. You need to manually move the files to the new location in the file system.

Use site-specific subfolders for custom files folder

This setting is only applied when a Custom form files folder is configured. If enabled, attachment files will be stored in a sub-folder named according to the code name of the site where the form is placed, i.e. <custom form files folder>/<site code name>. It is useful for better orientation in files when multiple sites are running in the system.

Custom form files folder

Folder where files uploaded via Forms are stored. You can use:

  • physical disk path: e.g. c:\myfiles\mysite
  • virtual path: ~/UploadedFiles
  • UNC path: \\server\folder

If you do not specify any value, form files are stored in the default folder: ~/<site code name>/BizFormFiles

Note: When you change the form file folder location, the system does NOT automatically move existing files to the new location. You need to manually move the files to the new location in the file system.

Use site-specific subfolders for custom form files folder

This setting is only applied when a Custom form files folder is configured. If enabled, attachment files will be stored in a sub-folder named as the site code name under the custom files folder, i.e. <custom BizForm files folder>/<site code name>. It is useful for better orientation in files when multiple sites are running in the system.

Security

Upload extensions

Specifies which extensions are allowed for uploaded files. You can restrict the types of uploaded files by entering a limited list of extensions separated by semicolons, for example: gif;jpg;doc;pdf

This allows you to block users from uploading potentially dangerous files, such as ASPX scripts. If no value is specified, uploading is allowed for all file types.

Check if files are published

If checked, only files that are in the Published workflow step can be accessed from the live site when a workflow is applied to the page.

Check files permissions

If checked, page permissions are applied to the files.

Image resizing

Automatic image resize on upload (width, height, max side size)

Configures the system to automatically reduce the size of images when they are uploaded. The values are measured in pixels. The behavior depends on the values that you fill in:

  • No values are entered - images are not resized.
  • Only width or only height - images are resized so that their width or height matches the entered value. The other dimension is also resized to preserve the image’s aspect ratio.
  • Both width and height - both dimensions of images are resized according to the specified values (if the given dimension is greater than the entered value). Aspect ratio is not preserved.
  • Max side size - if one of the image’s sides is larger than this value, the image is resized so that its larger side’s dimension matches the entered value. Aspect ratio is preserved and width and height settings are not applied.

See Resizing images on upload for more information.

Watermark

Watermark image

Allows you to specify an image file that the system adds as a watermark to images (according to the remaining settings in the category). There are two ways to set the watermark:

  • Enter the full relative path to a physical file on the server, for example ~/App_Themes/Default/Images/Powered_by_kentico.gif. You cannot use web links or images loaded using Kentico system pages, such as GetFile.
  • Enter only the name of an image file located in the ~/App_Themes/Default/Images/Watermarks folder.

Watermark position

Sets the position where the watermark is placed on the watermarked images.

Minimum image width for watermark

Minimum width of an image to be watermarked.

Minimum image height for watermark

Minimum height of an image to be watermarked.

Use watermark for page images

If enabled, the system adds the watermark to images stored as page attachments.

Use watermark for media files

If enabled, the system adds the watermark to images stored in media libraries.

Use watermark for object attachments

If enabled, the system adds the watermark to images stored as object attachments (metafiles).