---
title: "headliner:headline.row"
manual: "Headliner"
version: "main"
permalink: "https://docs.typo3.org/permalink/twtgroup/headliner:integration-headline-row@main"
source: "Integration/HeadlineRow/Index.rst"
rendered: "2026-11-11T13:53:21+00:00"
---

# headliner:headline.row {#integration-headline-row}

For a **row as an array**, as a data processor gives it.

A data processor such as `database-query` gives each row as an array, in `data` of each entry. Give the row, and a record is
made of it: the heading is then the one of `headliner:headline`, with nothing written by hand.

```html
<f:for each="{items}" as="item">
    <headliner:headline.row row="{item.data}" />
</f:for>
```

Everything is found by itself in the usual case. Name what is not:

```html
<!-- the content element has no inline field for the table of the row -->
<headliner:headline.row row="{item.data}" table="tx_myext_item" />

<!-- the text is not in the label field of the table, but in "name" -->
<headliner:headline.row row="{item.data}" textField="name" />

<!-- the table has two fields that are a select of tags: the tag is in "level" -->
<headliner:headline.row row="{item.data}" tagField="level" />

<!-- all together, and the subheader of the same row -->
<headliner:headline.row row="{item.data}" table="tx_myext_item" textField="name" tagField="level" />
<headliner:headline.row row="{item.data}" subheader="1" textField="teaser" />
```

The text comes from the label field of the table, the tag from its tag field, and the page module gets the table, the uid
and the field (see [headliner:headline](https://docs.typo3.org/permalink/twtgroup/headliner:integration-headline@main)). The table is found from the content element, which has an inline field
for it (the field with the table as `foreign_table`, to which the row points with its `foreign_field`); name it with
`table` if it has none. The row must have all the columns of its table (`database-query` gives them, a select of a few
columns does not): the core says which one is missing. A row whose table is not known gives no heading.

Only `row` is required:

| Argument | Required | When you need it | Without it |
| --- | --- | --- | --- |
| `row` | yes | Always: the row as an array, with all the columns of its table. | (required) |
| `table` | no | Only if the content element has **no** inline field for the table, or two of its fields would give different tables. | The table of the inline field of the content element |
| `textField` | no | Only if the text is **not** in the label field of the table, and there is no content between the tags. | The label field of the table (`subheader` with `subheader`) |
| `tagField` | no | Only if the table has **several** fields that are a select of tags. | The one such field of the table |
| `tag` | no | Only to force a tag that the row does not say: `h1` to `h6` or `div`. With `subheader` it is the tag of the subheader. | The tag from the tag field |
| `subheader` | no | A switch, `subheader="1"`: the heading is the subheader of the row, with its text from the field `subheader`. | The header |
| `parent` | no | Only if the content element is **not** the variable `data`. A record object or the array of one. | The variable `data` |
| `default` | no | Only to say the tag of a heading that has **no tag and no layout** (an editor chose none, the record has no layout from 1 to 6): a tag (`default="h2"`, `default="div"`) or a layout number from 1 to 6. The tag of the record and its layout win over it. | The setting `defaultHeaderType` of the content element, else `h2` |
| `offset` | no | Only for another distance than one level below the header of the parent. | 1 |

If the rows are records already, give them to [headliner:headline](https://docs.typo3.org/permalink/twtgroup/headliner:integration-headline@main).