TYPO3 v10 has reached end-of-life as of April 30th 2023 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 v10 here: TYPO3 ELTS.

TypoScript Coding Guidelines

Directory and File Names

  • As of TYPO3 8.7, the file ending can and should be .typoscript.

  • TypoScript files are located in the directory <extension>/Configuration/TypoScript.

  • File name for constants in static templates: constants.typoscript.

  • File name for TypoScript in static templates: setup.typoscript.

More information about the file ending:

  • TypoScript files used to have the ending .txt.

  • Since TYPO3 7, it is also possible to use the ending .ts. This is not recommended because it is also used by TypeScript.

  • Therefore, you should use .typoscript if you are using TYPO3 8.7 and later.


  • Use spaces, not TABs.

  • Use 2 spaces per indenting level.

More Information

  • See Setup IDE / Editor in this manual for information about setting up your Editor / IDE to adhere to the coding guidelines.