---
title: "TSconfig"
manual: "TYPO3 Explained"
version: "12.4"
permalink: "https://docs.typo3.org/permalink/t3coreapi:tsconfig@12.4"
source: "Configuration/TypoScript/TSconfig/Index.rst"
rendered: "2026-10-21T15:29:37+00:00"
---

> [!WARNING]
> **Attention**
>
> TYPO3 v12 has reached end-of-life as of April 30th 2026 and
> is no longer being maintained. Use the version switcher on the top
> left of this page to select documentation for a supported version of TYPO3.
>
> Need more time before upgrading?
> You can purchase Extended Long Term Support (ELTS) for TYPO3 v12 here:
> [TYPO3 ELTS](https://typo3.com/services/extended-support-elts).

# TSconfig {#tsconfig}

"user TSconfig" and "page TSconfig" are very flexible concepts for
adding fine-grained configuration to the TYPO3 backend. It is a text-based
configuration system where you assign values to keyword strings,
using the TypoScript syntax. The
[Page TSconfig Reference](https://docs.typo3.org/m/typo3/reference-typoscript/12.4/en-us/PageTsconfig/Index.html#pagetoplevelobjects) and
[User TSconfig reference](https://docs.typo3.org/m/typo3/reference-typoscript/12.4/en-us/UserTsconfig/Index.html#usertoplevelobjects)
describe in detail how this works and what can be done with it.

## User TSconfig {#tsconfig-user}

User TSconfig can be set for backend users and groups.
Configuration set for backend groups is inherited by the user who is a
member of those groups. The available options typically cover user
settings like those found in the **User Settings** module, various backend tweaks
(lock user to IP, may user clear caches?, etc.) and backend module configuration.

## Page TSconfig {#tsconfig-page}

Page TSconfig can be set for each page in the page tree. Pages
inherit configuration from parent pages. The available
options typically cover backend module configuration, which means that
modules related to pages can be configured for different behaviours in different
branches of the tree.

It also includes configuration for the [FormEngine](https://docs.typo3.org/permalink/t3coreapi:formengine@12.4) (Forms
to edit content in TYPO3) and the [DataHandler](https://docs.typo3.org/permalink/t3coreapi:datahandler-basics@12.4)
(component that takes care of transforming and persisting data
structures) behaviours. Again, the point is that the configuration is
active for certain branches of the page tree which is useful
in projects running many sites in the same page tree.