---
title: "Site settings"
manual: "TYPO3 Explained"
version: "11.5"
permalink: "https://docs.typo3.org/permalink/t3coreapi:sitehandling-settings@11.5"
source: "ApiOverview/SiteHandling/SiteSettings.rst"
rendered: "2026-10-21T15:30:00+00:00"
---

> [!WARNING]
> **Attention**
>
> TYPO3 v11 has reached end-of-life as of October 31th 2024 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 v11 here:
> [TYPO3 ELTS](https://typo3.com/services/extended-support-elts).

# Site settings {#sitehandling-settings}

It is possible to define a `settings` block in a site's
`config.yaml` which can be accessed both in backend and frontend via the
site object `\TYPO3\CMS\core\Site\Entity\Site`.

Additionally, these settings are available in both
[page TSconfig](https://docs.typo3.org/m/typo3/reference-tsconfig/11.5/en-us/PageTsconfig/Index.html#pagetsconfig) and
[TypoScript templates](https://docs.typo3.org/m/typo3/reference-typoscript/11.5/en-us/Index.html). This allows us, for example, to
configure site-wide storage page IDs which can be used in both frontend and
backend.

## Adding site settings {#adding-site-settings}

Add a `settings` block to the `config.yaml`:

**config/sites/\<some_site>/config.yaml | typo3conf/sites/\<some_site>/config.yaml**

```yaml
settings:
  categoryPid: 658
  styles:
    content:
      loginform:
        pid: 23

```

> [!NOTE]
> This example shows how to fill a constant of
> [EXT:felogin](https://docs.typo3.org/c/typo3/cms-felogin/11.5/en-us/Index.html) via site settings
> (`styles.content.loginform.pid`) and configures a custom
> `categoryPid`.

## Accessing site settings in page TSconfig or TypoScript {#accessing-site-settings-in-page-tsconfig-or-typoscript}

```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}
```

> [!NOTE]
> The TypoScript constants are evaluated in this order:
>
> 1.  Configuration from
>     [$GLOBALS\['TYPO3_CONF_VARS'\]\['FE'\]\['defaultTypoScript_constants'\]](https://docs.typo3.org/permalink/t3coreapi:typo3confvars-fe-defaulttyposcript-constants@11.5)
> 1.  Site specific settings from the site configuration
> 1.  Constants from `sys_template` database records