---
title: "listModule"
manual: "TCA Reference"
version: "main"
permalink: "https://docs.typo3.org/permalink/t3tca:tca-property-fieldcontrol-listmodule@main"
source: "ColumnsConfig/CommonProperties/FieldControl/ListModule.rst"
modified: "2026-09-17T12:35:22+00:00"
---

# listModule

-   **listModule**

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

    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

### disabled

-   **disabled**

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

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

### options\[pid\]

-   **options\[pid\]**

    -   *Type:* string
    -   *Path:* $GLOBALS\['TCA'\]\[$table\]\['columns'\]\[$field\]\['config'\]\['fieldControl'\]\['listModule'\]
    -   *Scope:* fieldControl -> addRecord
    -   *Values:* marker or an integer
    -   *Default:* ###CURRENT_PID###

    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@main).

    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\]

-   **options\[table\]**

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

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

### options\[title\]

-   **options\[title\]**

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

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

## 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

![](../../../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,
                    ],
                ],
            ],
        ],
    ],
]
```