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

# editPopup

-   **editPopup**

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

    The edit popup field control shows a pencil icon to edit an element directly in a popup window.
    When a record is selected and the edit button is clicked, that record opens in a new window for modification.

    > [!NOTE]
    > The edit popup control is pre-configured, but disabled by default. Enable it if you need it, the button
    > is by default shown below `element browser` and `insert clipboard`.

## Options

### disabled

-   **disabled**

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

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

### options\[title\]

-   **options\[title\]**

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

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

### options\[windowOpenParameters\]

-   **options\[windowOpenParameters\]**

    -   *Type:* string
    -   *Path:* $GLOBALS\['TCA'\]\[$table\]\['columns'\]\[$field\]\['config'\]\['fieldControl'\]\['editPopup'\]
    -   *Scope:* fieldControl -> editPopup
    -   *Values:* plain text label or [label reference](https://docs.typo3.org/permalink/t3coreapi:label-reference)
    -   *Default:* height=800,width=600,status=0,menubar=0,scrollbars=1

    Allows to set a different size of the popup, defaults

## 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,
                    ],
                ],
            ],
        ],
    ],
]
```