The “TSconfig” field

This is an example of the TSconfig field with a snippet of configuration for the Rich Text Editor. Precisely the Rich Text Editor is quite a good example of the usefulness of ‘Page TSconfig’. The reason is that you may need the RTE to work differently in different parts of the website. For instance you might need to offer other style-classes in certain parts of the website. Or some options might need to be removed in other parts. The ‘Page TSconfig’ is used to configure this.

The “TSconfig” field here is available in the tab called “Resources”:

The Page TSconfig field inside the page properties

Overwriting and modifying values

Properties, which are set in Page TSconfig, are valid for the page, on which they are set, and for all pages hierarchically below. You can overwrite and modify them in the Page TSconfig of the same page or a subpage.


  • Add in Page TSconfig
RTE.default.showButtons = bold
  • You get the value “bold”.
  • Add later in Page TSconfig
RTE.default.showButtons := addToList(italic)
  • Finally you get the value “bold,italic”.

Page TSconfig itself can be overwritten by User TSconfig.


It is not possible to modify Page TSconfig in User TSconfig. Page TSconfig can only be overwritten in User TSconfig.

Verifying the final configuration

If you need to check out the actual configuration for a certain branch in the website, use the ‘Web > Info’ module:

The Page TSconfig configuration for a page when using the Info module

Setting default Page TSconfig

Page TSconfig is designed to be individual for branches of the page tree. However it can be very handy to set global values that will be initialized from the root of the tree.

In extensions this is easily done by the extension API function, \TYPO3\CMS\Core\Utility\ExtensionManagementUtility::addPageTSConfig(). In the ext_localconf.php file of your extension you can call it like this to set default configuration:

        RTE.default {
                proc.preserveTables = 1
                showButtons = cut,copy,paste,fontstyle,fontsize,textcolor
                hideButtons = class,user,chMode

This API function during runtime adds the content to $TYPO3_CONF_VARS['BE']['defaultPageTSconfig'].