---
title: "TSconfig coding guidelines"
manual: "TYPO3 Explained"
version: "main"
permalink: "https://docs.typo3.org/permalink/t3coreapi:cgl-tsconfig@main"
source: "CodingGuidelines/CglTsConfig.rst"
modified: "2026-09-16T13:05:25+00:00"
---

# TSconfig coding guidelines

TSconfig files use TypoScript syntax.

## Directory and file names

-   Files have the ending `.tsconfig`

The following directory names are not mandatory, but recommended:

-   **TSconfig** files are located in the directory `<extension>/Configuration/TsConfig`
-   **Page TSconfig** files are located in the directory `<extension>/Configuration/TsConfig/Page`
-   **User TSconfig** files are located in the directory `<extension>/Configuration/TsConfig/User`
-   Configuration for [adding content elements to new content element wizard](https://docs.typo3.org/permalink/t3coreapi:content-element-wizard@main)
    are located in the file [`<extension>/Configuration/TsConfig/Page/Mod/Wizards/NewContentElement.tsconfig`](../ExtensionArchitecture/FileStructure/Configuration/TsConfig/Index.md#file-extension-configuration-tsconfig-pagesomething-tsconfig)

## Format

-   Use spaces, not tabs
-   Indent with 2 spaces per indent level

See [.editorconfig](https://github.com/typo3/typo3/blob/main/.editorconfig) in core.

## More information

-   See [Setup IDE / editor](https://docs.typo3.org/permalink/t3coreapi:cgl-ide@main) in this manual for information about setting up your Editor / IDE to adhere to
    the coding guidelines.
-   [Using and setting TSconfig](https://docs.typo3.org/m/typo3/reference-typoscript/main/en-us/UsingSettingTSconfig/Index.html#typoscript-syntax-using-setting)