---
title: "Be.tableList ViewHelper <f:be.tableList>"
manual: "Fluid ViewHelper Reference"
version: "main"
permalink: "https://docs.typo3.org/permalink/t3viewhelper:typo3-fluid-be-tablelist@main"
source: "Global/Be/TableList.rst"
modified: "2026-09-17T05:12:06+00:00"
---

git :navigation-title: be.tableList

# Be.tableList ViewHelper `<f:be.tableList>`

![Screenshot of a table of categories.](../../Images/BeTablelistCategory.png)

ViewHelper which renders a record list as known from the TYPO3 records module.

**Note:** This feature is experimental!

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

**Table of contents**

-   [Examples](https://docs.typo3.org/permalink/t3viewhelper:examples@main)
-   [Arguments of the <f:be.tableList> ViewHelper](https://docs.typo3.org/permalink/t3viewhelper:arguments-of-the-f-be-tablelist-viewhelper@main)

## Examples

Display and make editable the content elements of page 1 and its direct children:

**Code example**

**EXT:my_extension/Resources/Private/Backend/Templates/MyModule.fluid.html**

```html
<f:be.tableList
    tableName="tt_content"
    fieldList="{0: 'header', 1: 'CType'}"
    storagePid="1"
    levels="2"
    enableControlPanels="1"
/>

```

**Screenshot**

![Screenshot of a table of content elements with edit options.](../../Images/BeTablelist.png)

List all categories on page 5 and make them editable when clicking the title:

**Code example**

**EXT:my_extension/Resources/Private/Backend/Templates/MyModule.fluid.html**

```html
<f:be.tableList
    tableName="sys_category"
    fieldList="{0: 'title', 1: 'parent'}"
    storagePid="4"
    clickTitleMode="edit"
/>

```

**Screenshot**

![Screenshot of a table of categories.](../../Images/BeTablelistCategory.png)

## Arguments of the `<f:be.tableList>` ViewHelper

-   **clickTitleMode**

    -   *Type:* string
    -   *Default:* ''

    one of "edit", "show" (only pages, tt_content), "info

-   **enableClickMenu**

    -   *Type:* bool
    -   *Default:* true

    enables context menu

-   **enableControlPanels**

    -   *Type:* bool
    -   *Default:* false

    enables control panels

-   **fieldList**

    -   *Type:* array
    -   *Default:* array (
    )

    list of fields to be displayed. If empty, only the title column (configured in $TCA\[$tableName\]\['ctrl'\]\['title'\]) is shown

-   **filter**

    -   *Type:* string
    -   *Default:* ''

    corresponds to the "Search String" textbox of the TYPO3 records module. If not empty, only records matching the string will be fetched

-   **levels**

    -   *Type:* int
    -   *Default:* 0

    corresponds to the level selector of the TYPO3 records module. By default only records from the current storagePid are fetched

-   **readOnly**

    -   *Type:* bool
    -   *Default:* false

    if TRUE, the edit icons won't be shown. Otherwise edit icons will be shown, if the current BE user has edit rights for the specified table!

-   **recordsPerPage**

    -   *Type:* int
    -   *Default:* 0

    amount of records to be displayed at once. Defaults to 100

-   **sortDescending**

    -   *Type:* bool
    -   *Default:* false

    if TRUE records will be sorted in descending order

-   **sortField**

    -   *Type:* string
    -   *Default:* ''

    table field to sort the results by

-   **storagePid**

    -   *Type:* int

    by default, records are fetched from the storage PID configured in persistence.storagePid. With this argument, the storage PID can be overwritten

-   **tableName**

    -   *Type:* string
    -   *Required:* true

    name of the database table