---
title: "listModule"
manual: "TCA Reference"
version: "14.3"
permalink: "https://docs.typo3.org/permalink/t3tca:tca-property-fieldcontrol-listmodule@14.3"
source: "ColumnsConfig/CommonProperties/FieldControl/ListModule.rst"
rendered: "2026-10-01T16:42:39+00:00"
---

# listModule {#tca-property-fieldcontrol-listmodule}

-   **listModule**

    -   *Type:* array
    -   *TCA path:* $GLOBALS\['TCA'\]\[$table\]\['columns'\]\[$field\]\['config'\]\['fieldControl'\]\['listModule'\]
    -   *Scope:* Display
    -   *Types:* [group](https://docs.typo3.org/permalink/t3tca:columns-group@14.3)

    The list module control button opens the **Content > Records** module
    for only one table and allows the user to manipulate
    stuff there.

    > [!NOTE]
    > The list module control is disabled by default, enable it if needed. It is shown below the `add record`
    > control if not changed by `below` or `after` settings.

## Options {#tca-property-field-control-list-module-options}

### disabled {#tca-property-field-control-list-module-options-disabled}

-   **disabled**

    -   *Type:* boolean
    -   *Default:* true
    -   *TCA path:* $GLOBALS\['TCA'\]\[$table\]\['columns'\]\[$field\]\['config'\]\['fieldControl'\]\['listModule'\]\['disabled'\]
    -   *Scope:* Display

    Disables the field control. Needs to be set to `false` to enable the
    **Create new** button

### options\[pid\] {#tca-property-field-control-list-module-options-pid}

-   **options\[pid\]**

    -   *Type:* string
    -   *Default:* ###CURRENT_PID###
    -   *TCA path:* $GLOBALS\['TCA'\]\[$table\]\['columns'\]\[$field\]\['config'\]\['fieldControl'\]\['listModule'\]\['options'\]\['pid'\]
    -   *Scope:* Display
    -   *Values:* marker or an integer

    List records from this pid. Can be an hard pid setting, or one of
    these markers, see [select foreign_table_where](https://docs.typo3.org/permalink/t3tca:columns-select-properties-foreign-table-where@14.3).

    Falls back to "current pid" if not set, forces pid=0 if records of this
    table are only allowed on root level.

    -   `###CURRENT_PID###`
    -   `###THIS_UID###`
    -   `###SITEROOT###`

### options\[table\] {#tca-property-field-control-list-module-options-table}

-   **options\[table\]**

    -   *Type:* string
    -   *Default:* First table from property `allowed` / `foreign_table`
    -   *TCA path:* $GLOBALS\['TCA'\]\[$table\]\['columns'\]\[$field\]\['config'\]\['fieldControl'\]\['listModule'\]\['options'\]\['table'\]
    -   *Scope:* Display
    -   *Values:* name of the table

    List records of this table only, falls back to first table from
    [allowed](https://docs.typo3.org/permalink/t3tca:columns-group-properties-allowed@14.3) list if not set for
    `type='group'` fields and to [foreign_table](https://docs.typo3.org/permalink/t3tca:columns-select-properties-foreign-table@14.3) for `type='select'` fields.

### options\[title\] {#tca-property-field-control-list-module-options-title}

-   **options\[title\]**

    -   *Type:* string
    -   *Default:* `LLL:core.core:labels.list`
    -   *TCA path:* $GLOBALS\['TCA'\]\[$table\]\['columns'\]\[$field\]\['config'\]\['fieldControl'\]\['listModule'\]\['options'\]\['title'\]
    -   *Scope:* Display
    -   *Values:* plain text label or [label reference](https://docs.typo3.org/permalink/t3coreapi:label-reference)

    Allows to set a different 'title' attribute to the popup icon.

## Examples {#tca-property-field-control-list-module-examples}

### Select field {#tca-property-field-control-list-module-examples-select-field}

![](../../../Images/AutomaticScreenshots/SelectMultiplesidebyside6.png)

**EXT:styleguide/Configuration/TCA/tx_styleguide_elements_select.php**

```php
[
    'columns' => [
        'select_multiplesidebyside_6' => [
            'label' => 'select_multiplesidebyside_6 fieldControl',
            'config' => [
                'type' => 'select',
                'renderType' => 'selectMultipleSideBySide',
                'foreign_table' => 'tx_styleguide_staticdata',
                'size' => 5,
                'autoSizeMax' => 20,
                'fieldControl' => [
                    'editPopup' => [
                        'disabled' => false,
                        'options' => [
                            'windowOpenParameters' => 'height=300,width=500,status=0,menubar=0,scrollbars=1',
                        ],
                    ],
                    'addRecord' => [
                        'disabled' => false,
                    ],
                    'listModule' => [
                        'disabled' => false,
                    ],
                ],
            ],
        ],
    ],
]
```

### Group field {#tca-property-field-control-list-module-examples-group-field}

![](../../../Images/AutomaticScreenshots/GroupDb1.png)

**EXT:styleguide/Configuration/TCA/tx_styleguide_elements_group.php**

```php
[
    'columns' => [
        'group_db_1' => [
            'label' => 'group_db_1 allowed=be_users,be_groups description',
            'description' => 'field description',
            'config' => [
                'type' => 'group',
                'allowed' => 'be_users,be_groups',
                'fieldControl' => [
                    'editPopup' => [
                        'disabled' => false,
                    ],
                    'addRecord' => [
                        'disabled' => false,
                    ],
                    'listModule' => [
                        'disabled' => false,
                    ],
                ],
            ],
        ],
    ],
]
```