TYPO3 Exception 1509741908

Note

Below, the TYPO3 community may have provided additional information or solutions for this exception. However, these may or may not apply to your particular case. If you can provide more information, you should come back here and add your experience and solution steps to this issue once you have resolved it.

General TYPO3 troubleshooting tips can be found in the Troubleshooting section in the menu. You can also ask questions and receive support in the TYPO3 Questions category on talk.typo3.org.

To add your experience, click "Edit on GitHub" above and follow the "Edit on GitHub" workflow. Also check out our tip on Coding Style and reST.

TYPO3 13.4 - 2025-04-23

Installation overview

A content element has a relation to a custom record which itself has a relation to one image. When now using the record-transformation data processor and reference {data.record.image} in a <f:image> tag, the following exception is thrown:

Unable to render image uri in "tt_content:140": Supplied file must be File or 
FileReference, TYPO3\CMS\Core\Resource\Collection\LazyFileReferenceCollection given.

The issue

TYPO3 provides a collection by default which cannot be resolved by the ImageViewHelper.

Solution

Add 'relationship' => 'oneToOne' (or one of the other values if appropriate) to the config section in the TCA configuration of the according field. See: relationship