File 

If enabled, an additional image or media palette will be rendered. For image files it consists of the additional fields crop, alternative and link. For audio and media files an additional autoplay field is added. For other file types, like plain text, this option has no effect. Disable this option, if you don't need these additional fields.

Possible values: common-image-types, common-media-types or your custom list of file types.

Maximum number of child items. Defaults to a high value. JavaScript record validation prevents the record from being saved if the limit is not satisfied.

Minimum number of items. Default is no minimum. JavaScript record validation prevents the record from being saved if the limit is not satisfied. The field can be set as required by setting minitems to at least 1.

The relationship defines the cardinality between the relations. Possible values are oneToMany (default), or oneToOne. In case of a oneToOne relation, the processed field will be filled directly with the file reference instead of a collection of file references. In addition, maxitems will be automatically set to 1.

It is possible to define crop variants for this specific field and Content Block. This documentation only covers the most basic configuration. Refer to the TCA documentation for a complete overview of possibilities.

Example configuration below. The aspect ratios can be defined as a float value or a fraction. Only the simple division operation a / b is allowed.

cropVariants:
  default:
    title: Teaser
    allowedAspectRatios:
      portrait:
        title: Portrait
        value: 0.75
      landscape:
        title: Landscape
        value: 4 / 3
    coverAreas:
      - x: 0.25
        y: 0.3
        width: 0.5
        height: 0.4

Type Overrides can be used to override the File Definition in the context of as single field. Refer to the API documentation if you want to learn more.

overrideType:
  image:
    - identifier: image_overlay_palette
      type: Palette
      label: 'LLL:EXT:core/Resources/Private/Language/locallang_tca.xlf:sys_file_reference.imageoverlayPalette'
      fields:
        - identifier: alternative
          useExistingField: true
        - identifier: description
          useExistingField: true
        - type: Linebreak
        - identifier: link
          useExistingField: true
        - identifier: title
          useExistingField: true
        - type: Linebreak
        - identifier: example_custom_field
          type: Text
          label: 'My custom Field'
        - type: Linebreak
        - identifier: crop
          useExistingField: true

When true, all file records are shown collapsed. When false, all are expanded.

When enabled, only one file record is expanded at a time.

Overrides the "Create new relation" button label with a localized string.

Overrides the "Add media by URL" button label with a localized string.

Overrides the "Select & upload files" button label with a localized string.

Activates drag & drop sorting of file records.

Show unlocalized file records that exist in the original language but have not yet been translated.

Show a "Localize all records" link to fetch untranslated records from the original language.

Show a "Synchronize" link to update to a 1:1 translation with the original language.

Enables or disables individual controls on file records. Available keys with their defaults:

edit (bool, default true)

Show or hide the edit control.

info (bool, default true)

Show or hide the info control.

dragdrop (bool, default true)

Show or hide the drag & drop handle.

sort (bool, default false)

Show or hide the sort arrows.

hide (bool, default true)

Show or hide the hide/show toggle.

delete (bool, default true)

Show or hide the delete control.

localize (bool, default true)

Show or hide the localize control.

Example:

appearance:
  enabledControls:
    sort: true
    delete: false

Defines the dimensions of the preview thumbnail shown in the inline header. Accepts width and height as string or integer values.

Example:

appearance:
  headerThumbnail:
    width: 64
    height: 64

Show or hide the "Select & upload file" button.

Show or hide the "Add media by URL" button, used to embed media from services such as YouTube or Vimeo.

Show or hide the element browser button.

Allows to select if localization uses custom or default language value.

Disables automatic moving of file references when the parent record is moved.

When disabled, attached file references are not deleted when the parent record is deleted.

File extensions to disallow even if they are listed in allowed. Accepts the same values as allowed.

See TCA fieldInformation.

See TCA fieldWizard.

Overrides TCA configuration of the sys_file_reference records attached to this field.

Renders the field in a way that the user can see the value but cannot edit it.