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 .
  • Filename for constants in static templates: constants.typoscript .
  • Filename 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.