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

# TCAdefaults {#pagetstcadefaults}

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

The TCAdefaults configuration has been extended to support
type-specific syntax similar to TCEFORM,
enabling different default values based on the record type.

This allows the `default` values of `TCA` fields available
for various TCA column types to be set or overridden, for instance for
[type=input](https://docs.typo3.org/m/typo3/reference-tca/main/en-us/ColumnsConfig/Type/Input/Index.html#columns-input-properties-default).

Default values can be set at the type level: `TCAdefaults.[table name].[field].types.[type]`
or field level: `TCAdefaults.[table name].[field]`

This key is also available at the [User TSconfig level](https://docs.typo3.org/permalink/t3tsref:usertstcadefaults@main).
The order of setting default values when creating new records in the backend is
this:

1.  Database field default value
1.  Value from `$GLOBALS['TCA']`
1.  Field-level ref:`user TSconfig <userTsTcaDefaults>`
1.  Type-level ref:`user TSconfig <userTsTcaDefaults>`
1.  Field-level `TCAdefaults` configuration
1.  Type-level `TCAdefaults` configuration
1.  Value from "defVals" GET variables
1.  Value from previous record based on
    [useColumnsForDefaultValues](https://docs.typo3.org/m/typo3/reference-tca/main/en-us/Ctrl/Index.html#ctrl-reference-usecolumnsfordefaultvalues)

> [!NOTE]
> `TCAdefaults` are not applied to [FlexForm](https://docs.typo3.org/m/typo3/reference-coreapi/main/en-us/ApiOverview/FlexForms/Index.html#flexforms) values.
> These can only be set via `<default>` elements within the
> FlexForm data structure.

## Example: Do not hide newly created pages by default {#pagetstcadefaults-example}

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

```typoscript
TCAdefaults.pages.hidden = 0
```

## Example: Set type specific default values {#pagetstcadefaults-example-type}

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

```typoscript
TCAdefaults.tt_content {
  header_layout = 1
  header_layout.types {
    textmedia = 3
    image = 2
  }

  frame_class = default
  frame_class.types {
    textmedia = ruler-before
    image = none
  }

  space_before_class = none
}

```