---
title: "The list module"
manual: "Getting Started"
version: "13.4"
permalink: "https://docs.typo3.org/permalink/t3start:list-module@13.4"
source: "Concepts/Backend/ListModule/Index.rst"
rendered: "2026-09-27T06:58:01+00:00"
---

# The list module {#list-module}

Almost all data stored in the database is represented as a
[Database record](https://docs.typo3.org/m/typo3/reference-coreapi/13.4/en-us/ApiOverview/Database/DatabaseRecords/Index.html#database-records) in the TYPO3 backend.

The respective backend module called **Web > List** module can be
used to view, edit, search and export database records.

How to use the List module effectively for managing database records is
described in-depth in
[Editors Guide, Using the list module](https://docs.typo3.org/m/typo3/tutorial-editors/13.4/en-us/ListModule/UsingEffectively/Index.html#using-the-list-module-effectively).

For example there is a [Mass editing mode](https://docs.typo3.org/m/typo3/tutorial-editors/13.4/en-us/ListModule/MassEditing/Index.html#selective-editing) and
a [clipboard](https://docs.typo3.org/m/typo3/tutorial-editors/13.4/en-us/ListModule/AdvancedClipboard/Index.html#clipboard).

## Display of database records in the List module {#list-module-tca}

How a database record type is displayed in the list module is determined by
[TCA](https://docs.typo3.org/permalink/t3start:tca@13.4) and can be further configured by TSconfig. While TCA is always loaded
globally, TSconfig can be included on a per-site or per-page level.

Here are some examples of what you might want to change in the list module:

### Hide tables in the List module {#list-module-mod-hidetables}

The TSconfig properties in section [web_list](https://docs.typo3.org/m/typo3/reference-typoscript/13.4/en-us/PageTsconfig/Mod/WebList.html#pageweblist)
can be used to influence display and functionality of the List module.

For example you can hide the records of certain tables visible in the List module with:

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

```typoscript
mod.web_list {
    hideTables := addToList(tx_my_table,tx_my_table2)
}
```

We use the [operator ":="](https://docs.typo3.org/m/typo3/reference-typoscript/13.4/en-us/Syntax/Operators/Index.html#typoscript-syntax-syntax-value-modification) to add tables to a list that we want to hide.

### Disable hide and prepend at copy {#list-module-disablehideatcopy}

By default copied database records are inserted hidden and with `(copy X)`
appended to their label. You can disable this default behaviour by
setting [disablePrependAtCopy](https://docs.typo3.org/m/typo3/reference-typoscript/13.4/en-us/PageTsconfig/TceMain.html#pagetcemaintables-disableprependatcopy)
and [disableHideAtCopy](https://docs.typo3.org/m/typo3/reference-typoscript/13.4/en-us/PageTsconfig/TceMain.html#pagetcemaintables-disablehideatcopy) for
the affected table belonging to the record to true like so:

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

```typoscript
TCEMAIN.table.tx_my_table {
   disablePrependAtCopy = 1
   disableHideAtCopy = 1
}
```

### Define defaults for certain fields {#list-module-tcadefaults}

You can override the [default (TCA reference)](https://docs.typo3.org/m/typo3/reference-tca/13.4/en-us/ColumnsConfig/Type/Input/Index.html#confval-input-default)
set globally in the [TCA](https://docs.typo3.org/permalink/t3start:tca@13.4) by setting a custom default value in
TSconfig
[TCAdefaults](https://docs.typo3.org/m/typo3/reference-typoscript/13.4/en-us/PageTsconfig/TcaDefaults.html#pageTsTcaDefaults):

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

```typoscript
# Do not hide newly created pages by default
TCAdefaults.pages.hidden = 0

# Set the author of a news record to "Anonymous"
TCAdefaults.tx_news_domain_model_news.author = Anonymous
```