---
title: "web_list"
manual: "TypoScript Explained"
version: "main"
permalink: "https://docs.typo3.org/permalink/t3tsref:pageweblist@main"
source: "PageTsconfig/Mod/WebList.rst"
rendered: "2026-09-19T06:55:14+00:00"
---

# web_list {#pageweblist}

<!-- TODO: no Markdown rendering for "versionchanged" -->

The main module Web has been renamed to Content.
See Feature: #107628 - Improved backend module naming and structure

Configuration options of the **Content > Records** module.

-   [allowedNewTables](https://docs.typo3.org/permalink/t3tsref:allowednewtables@main)
-   [clickTitleMode](https://docs.typo3.org/permalink/t3tsref:clicktitlemode@main)
-   [csvDelimiter](https://docs.typo3.org/permalink/t3tsref:csvdelimiter@main)
-   [csvQuote](https://docs.typo3.org/permalink/t3tsref:csvquote@main)
-   [deniedNewTables](https://docs.typo3.org/permalink/t3tsref:deniednewtables@main)
-   [disableSearchBox](https://docs.typo3.org/permalink/t3tsref:disablesearchbox@main)
-   [disableSingleTableView](https://docs.typo3.org/permalink/t3tsref:disablesingletableview@main)
-   [displayColumnSelector](https://docs.typo3.org/permalink/t3tsref:displaycolumnselector@main)
-   [displayRecordDownload](https://docs.typo3.org/permalink/t3tsref:displayrecorddownload@main)
-   [downloadPresets](https://docs.typo3.org/permalink/t3tsref:downloadpresets@main)
-   [enableClipBoard](https://docs.typo3.org/permalink/t3tsref:enableclipboard@main)
-   [enableDisplayBigControlPanel](https://docs.typo3.org/permalink/t3tsref:enabledisplaybigcontrolpanel@main)
-   [hideTables](https://docs.typo3.org/permalink/t3tsref:hidetables@main)
-   [hideTranslations](https://docs.typo3.org/permalink/t3tsref:hidetranslations@main)
-   [itemsLimitPerTable](https://docs.typo3.org/permalink/t3tsref:itemslimitpertable@main)
-   [itemsLimitSingleTable](https://docs.typo3.org/permalink/t3tsref:itemslimitsingletable@main)
-   [listOnlyInSingleTableView](https://docs.typo3.org/permalink/t3tsref:listonlyinsingletableview@main)
-   [newPageWizard.override](https://docs.typo3.org/permalink/t3tsref:newpagewizard-override@main)
-   [noCreateRecordsLink](https://docs.typo3.org/permalink/t3tsref:nocreaterecordslink@main)
-   [noExportRecordsLinks](https://docs.typo3.org/permalink/t3tsref:noexportrecordslinks@main)
-   [noViewWithDokTypes (removed)](https://docs.typo3.org/permalink/t3tsref:noviewwithdoktypes-removed@main)
-   [table.[tableName].hideTable](https://docs.typo3.org/permalink/t3tsref:table-tablename-hidetable@main)
-   [table.[tableName].displayColumnSelector](https://docs.typo3.org/permalink/t3tsref:table-tablename-displaycolumnselector@main)
-   [tableDisplayOrder](https://docs.typo3.org/permalink/t3tsref:tabledisplayorder@main)
-   [searchLevel.items](https://docs.typo3.org/permalink/t3tsref:searchlevel-items@main)
-   [searchLevel.default](https://docs.typo3.org/permalink/t3tsref:searchlevel-default@main)

## allowedNewTables {#pagetsconfigweblistallowednewtables}

-   **allowedNewTables**

    -   *Type:* list of table names

    If this list is set, then only tables listed here will have a link to "create new" in the page and sub pages.
    This also affects the "Create new record" content element wizard.

    This is the opposite of [deniedNewTables property](https://docs.typo3.org/permalink/t3tsref:pagetsconfigweblistdeniednewtables@main).

    > [!NOTE]
    > Technically records can be created (e.g. by copying/moving), so this is not a security feature.
    > The point is to reduce the number of options for new records visually.

### Example: Allow records of type pages or sys_category in the new record wizard {#pagetsconfigweblistallowednewtable-example}

**EXT:site_package/Configuration/page.tsconfig**

```typoscript
mod.web_list {
  # Only pages and sys_category table elements will be linked to in the new record wizard
  allowedNewTables := addToList(sys_category)
  allowedNewTables := addToList(pages)
}

```

![The New record screen after modifying the allowed elements](../../Images/ManualScreenshots/List/PageTsModWebListAllowedNewTables.png)

## clickTitleMode {#pagetsconfigweblist-clicktitlemode}

-   **clickTitleMode**

    -   *Type:* string
    -   *Default:* edit

    Keyword which defines what happens when a user clicks a record title in the list.

    The following values are possible:

    -   **edit**

        Edits record

    -   **info**

        Shows information

    -   **show**

        Shows page in the frontend

## csvDelimiter {#pagetsconfigweblist-csvdelimiter}

-   **csvDelimiter**

    -   *Type:* string
    -   *Default:* `,`

    Defines the default delimiter for CSV downloads (Microsoft Excel expects
    `;` to be set). The value set will be displayed as default delimiter in the
    download dialog in the **Content > Records** module.

### Example: Use semicolon as delimiter CSV downloads {#page-ts-config-web-list-csv-delimiter-example-semicolon-delimiter}

**EXT:examples/Configuration/TsConfig/Page/Mod/csvExport.tsconfig**

```typoscript
mod.web_list {
  csvDelimiter = ;
  csvQuote = '
}

```

![1](../../Images/ManualScreenshots/WebList/ExportDialog.png)

## csvQuote {#pagetsconfigweblist-csvquote}

-   **csvQuote**

    -   *Type:* string
    -   *Default:* `"`

    Defines the default quoting character for CSV downloads. The value set will
    be displayed as default quoting in the download dialog in the
    **Content > Records** module.

### Example: Use single quotes as quoting character for CSV downloads {#pagetsconfigweblist-csvquote-example}

**EXT:examples/Configuration/TsConfig/Page/Mod/csvExport.tsconfig**

```typoscript
mod.web_list {
  csvDelimiter = ;
  csvQuote = '
}

```

![1](../../Images/ManualScreenshots/WebList/ExportDialog.png)

## deniedNewTables {#pagetsconfigweblistdeniednewtables}

-   **deniedNewTables**

    -   *Type:* list of table names

    If this list is set, then the tables listed here won't have a link to "create new record" in the page
    and sub pages. This also affects the "Create new record" content element wizard.

    This is the opposite of [allowedNewTables property](https://docs.typo3.org/permalink/t3tsref:pagetsconfigweblistallowednewtables@main).

    If `allowedNewTables` and `deniedNewTables` contain a common subset, `deniedNewTables` takes precedence.

### Hide "Create new record" links in tables sys_category and tt_content {#page-ts-config-web-list-denied-new-tables-hide-create}

**EXT:site_package/Configuration/page.tsconfig**

```typoscript
mod.web_list {
  deniedNewTables := addToList(sys_category)
  deniedNewTables := addToList(tt_content)
}

```

## disableSearchBox {#pagetsconfigweblist-disablesearchbox}

-   **disableSearchBox**

    -   *Type:* boolean

    If set, the checkbox "Show search" in the **Content > Records** module is hidden.

## disableSingleTableView {#pagetsconfigweblist-disablesingletableview}

-   **disableSingleTableView**

    -   *Type:* boolean

    If set, then the links on the table titles which shows a single table
    listing will not be available - including sorting links on columns
    titles, because these links jumps to the table-only view.

## displayColumnSelector {#pagetsconfigweblist-displaycolumnselector}

-   **displayColumnSelector**

    -   *Type:* boolean
    -   *Default:* `true`

    The column selector is enabled by default and can be disabled with this
    option. The column selector is displayed at the top of each record list in
    the **List** module. It can be used to compare different fields of
    the listed records.

## displayRecordDownload {#pagetsconfigweblist-displayrecorddownload}

-   **displayRecordDownload**

    -   *Type:* boolean
    -   *Default:* `1`

    The "Download" functionality is available in the **Content > Records**
    module via the "Download" button in the relevant
    table header row. It is available in both the list and the single table
    view and can be managed using this option.

    As well as the general option, it is also possible to set this option on
    a table basis using the
    `mod.web_list.table.<tablename>.displayRecordDownload` option.
    If this option is set, it takes precedence over the general option.

    **packages/my_sitepackage/Configuration/Sets/MySet/page.tsconfig**

    ```typoscript
    # Page TSconfig
    mod.web_list {
      # Disable "Export" button in Content Records module header
      noExportRecordsLinks = 1

      # Generally disable "Download" button
      displayRecordDownload = 0

      # Enable "Download" button for table "tt_content"
      table.tt_content.displayRecordDownload = 1
    }

    ```

### Example: Hide the column selector {#pagetsconfigweblist-displaycolumnselector-example}

**EXT:site_package/Configuration/page.tsconfig**

```typoscript
mod.web_list.displayColumnSelector = 0
```

## downloadPresets {#pagetsconfigweblist-downloadpresets}

-   **downloadPresets.\[table\]**

    -   *Type:* array of presets

    This property adds presets of preselected fields to the download area in
    the **Content > Records** backend module.

    Those presets can be configured via page TSconfig, and can also be
    overridden via user TSconfig (for example, to expand certain presets
    only to specific users).

    Each entry of `mod.web_list.downloadPresets`
    defines the table name on the first level, followed by
    any number of presets.

    Each preset contains a `label` (the displayed name of the preset,
    which can be a locallang key), a comma-separated list of each column that
    should be included in the export as `columns` and optionally
    an `identifier`. In case `identifier` is not provided,
    the identifier is generated as hash of the `label` and
    `columns`.

    Since any table can be configured for a preset, any extension
    can deliver a defined set of presets through the
    `EXT:my_extension/Configuration/page.tsconfig` file and
    their table name(s).

    Additionally, the list of presets can be manipulated via the PSR-14 event
    [TYPO3CMSBackendRecordListEventBeforeRecordDownloadPresetsAreDisplayedEvent](https://docs.typo3.org/m/typo3/reference-coreapi/main/en-us/ApiOverview/Events/Events/Backend/BeforeRecordDownloadPresetsAreDisplayedEvent.html#BeforeRecordDownloadPresetsAreDisplayedEvent).

### Example: Create download presets for table page {#pagetsconfigweblist-downloadpresets-example}

**EXT:my_extension/Configuration/page.tsconfig**

```typoscript
mod.web_list.downloadPresets {
  pages {
    minimum {
      label = Quick overview
      columns = uid, title, crdate, slug
    }

    fullExport {
      identifier = uid-title
      label = LLL:my_extension.messages:preset2.label
      columns = uid, title
    }
  }
}

```

This can be manipulated with user TSconfig by adding the `page.`
prefix. User TSconfig is loaded after page TSconfig, so you can overwrite
the existing default settings using the same TypoScript path.

**EXT:my_extension/Configuration/user.tsconfig**

```typoscript
page.mod.web_list.downloadPresets {
  pages {
    minimum {
      label = Quick overview (customized)
      columns = uid, title, crdate, slug
    }

    fullExport {
      label = Short with URL
      columns = uid, title, slug
    }
  }
}

```

## enableClipBoard {#pagetsconfigweblist-enableclipboard}

-   **enableClipBoard**

    -   *Type:* list of keywords
    -   *Default:* `selectable`

    Determines whether the checkbox "Show clipboard" in the
    **Content > Records** module is
    shown or hidden. If it is hidden, you can predefine it to be always
    activated or always deactivated.

    The following values are possible:

    -   **activated**

        The option is activated and the checkbox is hidden.

    -   **deactivated**

        The option is deactivated and the checkbox is hidden.

    -   **selectable**

        The checkbox is shown so that the option can be selected by the user.

## enableDisplayBigControlPanel {#pagetsconfigweblist-enabledisplaybigcontrolpanel}

<!-- TODO: no Markdown rendering for "versionchanged" -->

The checkbox Extended view was removed with TYPO3 v11.3.
Therefore the option mod.web_list.enableDisplayBigControlPanel
has no effect anymore.

## hideTables {#pagetsconfigweblist-hidetables}

-   **hideTables**

    -   *Type:* list of table names, or \*

    Hide these tables in record listings (comma-separated)

    If `*` is used, all tables will be hidden

## hideTranslations {#pagetsconfigweblist-hidetranslations}

-   **hideTranslations**

    -   *Type:* list of table names, or \*

    For tables in this list all their translated records in additional website languages will be hidden
    in the **Content > Records** module.

    Use `*` to hide all records of additional website languages in all tables or set
    single table names as comma-separated list.

### Example: Hide all translated records {#pagetsconfigweblist-hidetranslations-example-all}

**EXT:site_package/Configuration/page.tsconfig**

```typoscript
mod.web_list.hideTranslations = *
```

### Example: Hide translated records in tables tt_content and tt_news {#pagetsconfigweblist-hidetranslations-example}

**EXT:site_package/Configuration/page.tsconfig**

```typoscript
mod.web_list.hideTranslations = tt_content, tt_news
```

## itemsLimitPerTable {#pagetsconfigweblist-itemslimitpertable}

-   **itemsLimitPerTable**

    -   *Type:* positive integer
    -   *Default:* 20

    Set the default maximum number of items to show per table.
    The number must be between `0` and `10000`. If below or above this range,
    the nearest valid number will be used.

    If a value is defined in the `$TCA[<table>]['interface']['maxDBListItems']`
    of the table, it will override this TSconfig option.
    For example, the `maxDBListItems` for the `pages` table is `30` by default.

### Example: Limit items per table in overview to 10 {#pagetsconfigweblist-itemslimitpertable-example}

**EXT:site_package/Configuration/page.tsconfig**

```typoscript
mod.web_list {
    itemsLimitPerTable = 10
}
```

## itemsLimitSingleTable {#pagetsconfigweblist-itemslimitsingletable}

-   **itemsLimitSingleTable**

    -   *Type:* positive integer
    -   *Default:* 100

    Set the default maximum number of items to show in single table view.
    The number must be between `0` and `10000`. If below or above this range,
    the nearest valid number will be used.

    If a value is defined in the `$TCA[<table>]['interface']['maxSingleDBListItems']`
    of the table, it will override this TSconfig option.
    For example, the `maxSingleDBListItems` for the `pages` table is `50` by default.

### Example: Limit items in single table view to 10 {#pagetsconfigweblist-itemslimitsingletable-example}

**EXT:site_package/Configuration/page.tsconfig**

```typoscript
mod.web_list {
    itemsLimitSingleTable = 10
}
```

## listOnlyInSingleTableView {#pagetsconfigweblist-listonlyinsingletableview}

-   **listOnlyInSingleTableView**

    -   *Type:* boolean
    -   *Default:* 0

    If set, the default view will not show the single records inside a
    table anymore, but only the available tables and the number of records
    in these tables. The individual records will only be listed in the
    single table view, that means when a table has been clicked. This is
    very practical for pages containing many records from many tables!

### Example: Only list records of tables in single-table mode {#pagetsconfigweblist-listonlyinsingletableview-example}

**EXT:site_package/Configuration/page.tsconfig**

```typoscript
mod.web_list {
    listOnlyInSingleTableView = 1
}
```

The result will be that records from tables are only listed in the single-table mode:

![The Content Records module after activating the single-table mode](../../Images/ManualScreenshots/List/PageTsModWebListListOnlyInSingleTableView.png)

## newPageWizard.override {#pagetsconfigweblist-newpagewizard-override}

-   **newPageWizard.override**

    -   *Type:* string

    If set to an extension key, then the specified module or route will be used for creating
    new elements on the page.

## noCreateRecordsLink {#pagetsconfigweblist-nocreaterecordslink}

-   **noCreateRecordsLink**

    -   *Type:* boolean
    -   *Default:* 0

    If set, the link "Create new record" is hidden.

### Example: Hide the "Create new record" link. {#pagetsconfigweblist-nocreaterecordslink-example}

**EXT:site_package/Configuration/page.tsconfig**

```typoscript
mod.web_list {
    noCreateRecordsLink = 1
}
```

## noExportRecordsLinks {#pagetsconfigweblist-noexportrecordslinks}

-   **noExportRecordsLinks**

    -   *Type:* boolean
    -   *Default:* 0

    If set, the **Download** button is hidden
    in the **Content > Records** module.

    This option is important, for example, to disable batch
    download of sensitive data via t3d exports.

    ![1](../../Images/ManualScreenshots/WebList/WithExportButtons.png)

    ![1](../../Images/ManualScreenshots/WebList/NoExportButtons.png)

    > [!NOTE]
    > This option only hides the buttons in the **Content > Records**
    > module. Bulk export of data is still possible via the context menu of
    > the page tree.

### Example: Hide the "Download" and "Export" links {#pagetsconfigweblist-noexportrecordslinks-example}

**EXT:examples/Configuration/TsConfig/Page/Mod/noExportRecordsLinks.tsconfig**

```typoscript
mod.web_list {
  noExportRecordsLinks = 1
}

```

## noViewWithDokTypes (removed) {#pagetsconfigweblist-noviewwithdoktypes}

<!-- TODO: no Markdown rendering for "versionchanged" -->

The TSconfig option mod.web_list.noViewWithDokTypes has been
removed since it just duplicated the existing configuration
TCEMAIN.preview.disableButtonForDokType.

Remove any usage of `mod.web_list.noViewWithDokTypes` from Page
TSconfig.

Instead, configure the equivalent behavior using:

**EXT:site_package/Configuration/TSconfig/Page/TCEMAIN.tsconfig**

```typoscript
TCEMAIN.preview.disableButtonForDokType = 199, 254
```

## table.\[tableName\].hideTable {#pagetsconfigweblist-table-tablename-hidetable}

-   **table.\[tableName\].hideTable**

    -   *Type:* boolean
    -   *Default:* 0

    If set to non-zero, the table is hidden. If it is zero, table is shown
    even if table name is listed in "hideTables" list.

### Example: Hide table tt_content {#pagetsconfigweblist-table-tablename-hidetable-example}

**EXT:site_package/Configuration/page.tsconfig**

```typoscript
mod.web_list.table.tt_content.hideTable = 1
```

## table.\[tableName\].displayColumnSelector {#pagetsconfigweblist-table-tablename-displaycolumnselector}

-   **table.\[tableName\].displayColumnSelector**

    -   *Type:* boolean

    If set to false, the column selector in the title row of the specified
    table gets hidden. If the column selectors have been disabled globally
    this option can be used to enable it for a specific table.

### Example: Hide the column selector for tt_content {#pagetsconfigweblist-table-tablename-displaycolumnselector-example-disable}

**EXT:site_package/Configuration/page.tsconfig**

```typoscript
mod.web_list.table.tt_content.displayColumnSelector = 0
```

### Example: Hide the column selector for all tables but sys_category {#pagetsconfigweblist-table-tablename-displaycolumnselector-example-enable}

**EXT:site_package/Configuration/page.tsconfig**

```typoscript
mod.web_list.displayColumnSelector = 0
mod.web_list.table.sys_category.displayColumnSelector = 1
```

## tableDisplayOrder {#pagetsconfigweblist-tabledisplayorder}

-   **tableDisplayOrder.\[tableName\]**

    -   *Type:* array

    Flexible configuration of the order in which tables are displayed.

    The keywords `before` and `after` can be used to specify an order relative
    to other table names.

    **EXT:site_package/Configuration/Sets/Main/page.tsconfig**

    ```typoscript
    mod.web_list.tableDisplayOrder.<tableName> {
      before = <tableA>, <tableB>, ...
      after = <tableA>, <tableB>, ...
    }

    ```

## searchLevel.items {#pagetsconfigweblist-searchlevel-items}

-   **searchLevel.items**

    -   *Type:* array

    Sets labels for each level label in the search level select box

    **EXT:site_package/Configuration/page.tsconfig**

    ```typoscript
    mod.web_list.searchLevel.items {
      -1 = LLL:core.core:labels.searchLevel.infinite
      0 = LLL:core.core:labels.searchLevel.0
      1 = LLL:core.core:labels.searchLevel.1
      2 = LLL:core.core:labels.searchLevel.2
      3 = LLL:core.core:labels.searchLevel.3
      4 = LLL:core.core:labels.searchLevel.4
    }

    ```

## searchLevel.default {#pagetsconfigweblist-searchlevel-default}

-   **searchLevel.default**

    -   *Type:* integer

    This option allows to define one of the available level options
    as the default level to use.

    When searching for records in the **Content > Records** module as well as
    the database browser, it is possible to select the search levels (page tree
    levels to respect in the search).

    An editor is therefore able to select between the current page, a couple of
    defined levels (e.g. 1, 2, 3) as well as the special "infinite levels".

    Those options can already be extended using the TSconfig option
    [searchLevel.items](https://docs.typo3.org/permalink/t3tsref:confval-mod-web-list-searchlevel-items@main).

### Example: Set the default search level to "infinite levels" {#pagetsconfigweblist-searchlevel-default-example}

**EXT:my_sitepackage/Configuration/page.tsconfig**

```typoscript
mod.web_list.searchLevel.default = -1
```
