View Source

Class ContentImagingSettings

Typed configuration options for content imaging settings.

Inheritance
object
Namespace: Umbraco.Cms.Core.Configuration.Models
Assembly: Umbraco.Core.dll
Syntax
public class ContentImagingSettings

Constructors

View Source

ContentImagingSettings()

Declaration
public ContentImagingSettings()

Properties

View Source

AutoFillImageProperties

Gets or sets the collection of media property mappings that are automatically populated with image metadata after a media file is uploaded.

Declaration
public ISet<ImagingAutoFillUploadField> AutoFillImageProperties { get; set; }
Property Value
Type Description
ISet<ImagingAutoFillUploadField>
View Source

ImageFileTypes

Gets or sets a value for the collection of native image format extensions that don't require format conversion. These are true image formats (JPG, PNG, GIF, WebP, etc.) that can be processed directly without conversion. For configuration, see appsettings.json under Umbraco:CMS:Content:Imaging:ImageFileTypes.

Declaration
public ISet<string> ImageFileTypes { get; set; }
Property Value
Type Description
ISet<string>
Remarks

This setting is used in multiple ways throughout Umbraco:

  1. Thumbnail Format Determination (Factory Layer) When generating image thumbnails via the Management API, the resize factory checks if the source file extension is in this list. If the extension is NOT found (e.g., PDF, EPS), the system automatically converts the output to WebP format for browser compatibility. Native image formats keep their original format unless explicitly overridden.
  2. Backoffice UI Configuration (Temporary File API) This list is exposed to the Umbraco backoffice via the temporary file configuration endpoint (/umbraco/management/api/v1/temporary-file/configuration). The frontend uses this to understand which file extensions represent native images vs. other processable file types. This helps the UI make informed decisions about how to handle different media file types.

Configuration example (appsettings.json): 

{
  "Umbraco": {
    "CMS": {
      "Content": {
        "Imaging": {
          "ImageFileTypes": ["jpeg", "jpg", "gif", "bmp", "png", "tiff", "tif", "webp"]
        }
      }
    }
  }
}

Note: This setting defines which formats are "native images" and is separate from what ImageSharp can process. ImageSharp may support additional formats through plugins (e.g., PDF via community packages), but those would not be in this list since they require conversion to a standard image format.