---
title: "Feature: #99048 - Site settings read API"
manual: "TYPO3 Core Changelog"
version: "main"
permalink: "https://docs.typo3.org/permalink/changelog:feature-99048-1668081533"
source: "Changelog/12.1/Feature-99048-SiteSettingsReadAPI.rst"
modified: "2026-09-14T09:47:36+00:00"
---

# Feature: #99048 - Site settings read API

See [forge#99048](https://forge.typo3.org/issues/99048)

## Description

Settings for site-specific functionality can now be retrieved by a dedicated
`\TYPO3\CMS\Core\Site\Entity\SiteSettings` object, accessible via a
`\TYPO3\CMS\Core\Site\Entity\Site` object like `$site->getSettings()`.

Settings can be used in custom frontend code to deliver features which might
vary per-site for extensions.

## Impact

Accessing site settings, which was previously possible via:

`$site->getConfiguration()['settings']['redirects'] ?? []`

in custom PHP code, is now easier via the `SiteSettings` PHP object.

The `SiteSettings` object can be used to access settings either by
the dot notation ("flat", a default value can be given as optional second
argument), e.g.:

```php
$redirectStatusCode = (int)$siteSettings->get('redirects.httpStatusCode', 307);
```

or by accessing all options for a certain group:

```php
$allSettingsRelatedToRedirects = $siteSettings->get('redirects');
```

or even fetching all settings:

```php
$allSettings = $siteSettings->all();
```

In addition, settings can now be accessed in TypoScript via `getData`
with the key `siteSettings`:

```typoscript
page.10 = TEXT
page.10.data = siteSettings:redirects.httpStatusCode
```