---
title: "Render.record ViewHelper <f:render.record>"
manual: "Fluid ViewHelper Reference"
version: "main"
permalink: "https://docs.typo3.org/permalink/t3viewhelper:typo3-fluid-render-record@main"
source: "Global/Render/Record.rst"
modified: "2026-09-17T05:12:06+00:00"
---

# Render.record ViewHelper `<f:render.record>`

> [!NOTE]
> **New in version 14.2**
>
> Instead of using the `<f:cObject>` ViewHelper to render database records,
> use the new `<f:render.record>` ViewHelper.

This ViewHelper renders a record object via its TypoScript definition. The
most common use case is rendering a content element that is available as a
record object in a Fluid template.

By default, the ViewHelper renders the record as-is. However, event listeners
can listen to the `\TYPO3\CMS\Fluid\Event\ModifyRenderedRecordEvent`
to modify the output.

Go to the source code of this ViewHelper: [Render\\RecordViewHelper.php (GitHub)](https://github.com/TYPO3/typo3/blob/main/typo3/sysext/fluid/Classes/ViewHelpers/Render/RecordViewHelper.php).

**Table of contents**

-   [Rendering content elements using the record-transformation data processor](https://docs.typo3.org/permalink/t3viewhelper:rendering-content-elements-using-the-record-transformation-data-processor@main)
-   [Rendering arbitrary database records](https://docs.typo3.org/permalink/t3viewhelper:rendering-arbitrary-database-records@main)
-   [Rendering records with types](https://docs.typo3.org/permalink/t3viewhelper:rendering-records-with-types@main)
-   [Intercepting the rendering of records via events](https://docs.typo3.org/permalink/t3viewhelper:intercepting-the-rendering-of-records-via-events@main)
-   [Arguments of the <f:render.record> ViewHelper](https://docs.typo3.org/permalink/t3viewhelper:arguments-of-the-f-render-record-viewhelper@main)

## Rendering content elements using the `record-transformation` data processor

**Fluid**

**packages/my_sitepackage/Resources/Private/Templates/Content/MyContent.fluid.html**

```html
<f:render.record record="{record}"/>
```

Or using inline syntax:

**packages/my_sitepackage/Resources/Private/Templates/Content/Default.fluid.html**

```html
{record -> f:render.record()}
```

**TypoScript**

**packages/my_sitepackage/Configuration/Sets/main/setup.typoscript**

```typoscript
dataProcessing {
    10 = record-transformation
}
```

## Rendering arbitrary database records

You can render any database record that has valid
[TCA](https://docs.typo3.org/m/typo3/reference-tca/main/en-us/Index.html#start), including categories and
records provided by third-party extensions.

### Rendering system categories

You can render not only `tt_content` records but any database record by defining
a top-level TypoScript object with the name of the record table.

For example, to render system categories, use `sys_category = FLUIDTEMPLATE`
([FLUIDTEMPLATE](https://docs.typo3.org/m/typo3/reference-typoscript/main/en-us/ContentObjects/Fluidtemplate/Index.html#cobj-template))
to configure the rendering.

**TypoScript rendering definition**

**packages/my_sitepackage/Configuration/Sets/main/setup.typoscript**

```typoscript
sys_category = FLUIDTEMPLATE
sys_category {
  file = EXT:my_sitepackage/Resources/Private/Templates/Category/Default.fluid.html
  layoutRootPaths.10 = EXT:my_sitepackage/Resources/Private/Layouts/Category/
  partialRootPaths.10 = EXT:my_extension/Resources/Private/Partials/Category/
  dataProcessing.1774685451 = record-transformation
}
```

**Fluid**

**EXT:my_sitepackage/Resources/Private/Templates/Partials/Categories.fluid.html**

```html
<f:for each="{categories}" as="category">
    {category -> f:render.record()}
</f:for>
```

**TypoScript page definition**

**packages/my_sitepackage/Configuration/Sets/main/setup.typoscript**

```typoscript
page = PAGE
page {
  10 = PAGEVIEW
  10 {
    paths.10 = EXT:my_sitepackage/Resources/Private/Templates/
    dataProcessing {
      10 = database-query
      10 {
        as = categories
        table = sys_category
        where = parent=0
        dataProcessing.1774685450 = record-transformation
      }
    }
  }
}
```

## Rendering records with types

If you want to render a database record that has different
[types](https://docs.typo3.org/m/typo3/reference-tca/main/en-us/Types/Index.html#types-introduction), you can
use a TypoScript [Content object array (COA)](https://docs.typo3.org/m/typo3/reference-typoscript/main/en-us/ContentObjects/CoaAndCoaInt/Index.html#cobj-coa-int)
to configure rendering for special types:

**packages/my_sitepackage/Configuration/Sets/main/setup.typoscript**

```typoscript
tx_myextension_domain_model_product = COA
tx_myextension_domain_model_product {
    key {
        field = my_type
    }
    default = FLUIDTEMPLATE
    default {
      templateName >
      templateName.ifEmpty.cObject = TEXT
      templateName.ifEmpty.cObject {
        field = record_type
        required = 1
        case = uppercamelcase
      }
      # for record_type = 'mainProduct' the template file my_extension/Resources/Private/Templates/Product/MainProduct.fluid.html will be used
      templateRootPaths.10 = EXT:my_extension/Resources/Private/Templates/Product/
      layoutRootPaths.10 = EXT:my_extension/Resources/Private/Layouts/
      partialRootPaths.10 = EXT:my_extension/Resources/Private/Partials/
      dataProcessing.1421884800 = record-transformation
    }
    mySpecialType.templateRootPaths.20 = EXT:my_extension/Resources/Private/Templates/ProductSpecial/
}
```

## Intercepting the rendering of records via events

With the `\TYPO3\CMS\Fluid\Event\ModifyRenderedRecordEvent`, developers can
intercept the rendering of individual records in Fluid templates to modify the
output.

## Arguments of the `<f:render.record>` ViewHelper

-   **record**

    -   *Type:* TYPO3\\CMS\\Core\\Domain\\RecordInterface

    The record to be rendered