Site settings 

New in version 13.1

Site settings can receive a type, a default value and some documentation in site settings definitions. It is recommended to always define a site setting before using it, as only this way you can ensure proper types and default values.

Changed in version 13.4.15

Site settings can be used to provide settings for a site. They can be accessed via

For instance, settings can be used in custom frontend code to deliver features which might vary per site for extensions. An example may be to configure storage page IDs.

All changes made in the site settings editor are stored in the settings.yaml file located in config/sites/<my_site>/. If this file does not exist, TYPO3 will create it automatically.

To store values independently of the site settings editor, use the settings.yaml file in the folder Configuration/Sets/<my_site>/ of your site package. This file itself remains untouched, but its values are overwritten by values from the settings.yaml in config/sites/<my_site>/.

Adding site settings 

Add settings to the settings.yaml:

config/sites/<my_site>/settings.yaml | typo3conf/sites/<my_site>/settings.yaml
categoryPid: 658
styles.content.loginform.pid: 23
Copied!

Changed in version 13.4.15

Accessing site settings in page TSconfig or TypoScript 

// store tx_ext_data records on the given storage page by default (e.g. through IRRE)
TCAdefaults.tx_ext_data.pid = {$categoryPid}

// load category selection for plugin from out dedicated storage page
TCEFORM.tt_content.pi_flexform.ext_pi1.sDEF.categories.PAGE_TSCONFIG_ID = {$categoryPid}
Copied!