---
title: "Site settings editor"
manual: "TYPO3 Explained"
version: "13.4"
permalink: "https://docs.typo3.org/permalink/t3coreapi:site-settings-editor@13.4"
source: "ApiOverview/SiteHandling/SiteSettingsEditor.rst"
rendered: "2026-09-19T07:17:26+00:00"
---

# Site settings editor {#site-settings-editor}

<!-- TODO: no Markdown rendering for "versionadded" -->

The site setting editor has been introduced as backend module
Site Management > Settings.

In module **Site Management > Settings** you get an overview of all sites in
the current installation and can edit the [Site settings](https://docs.typo3.org/permalink/t3coreapi:sitehandling-settings@13.4) for
all pages that contain settings:

![Screenshot of the Site Settings module in overview](../../Images/ManualScreenshots/SiteHandling/SiteSettingsOverview.png)

The settings editor displays the settings of all site sets included in the
current site, including their dependencies. The site sets can define categories
and subcategories to order the settings.

![Screenshot of the settings of an example site](../../Images/ManualScreenshots/SiteHandling/SiteSettings.png)

The settings to be displayed here have to be defined in an extension's or
site packages's set in a [setting definition](https://docs.typo3.org/permalink/t3coreapi:site-settings-definition@13.4) file, for example
[`EXT:my_sitepackage/Configuration/Sets/MySitepackage/settings.definitions.yaml`](../../ExtensionArchitecture/FileStructure/Configuration/Sets/Index.md#file-set-settings-definitions-yaml).

Settings that have been made directly in the `settings.yaml` file without a
corresponding entry in a `settings.definitions.yaml` are not displayed in
the editor as they have neither a type nor a label. These values are, however,
retained when the editor writes to the `settings.yaml` file.

## Configuring the site settings editor {#sitehandling-settings-editor-configuration}

![Screenshot demonstration the position of the categories, labels etc](../../Images/ManualScreenshots/SiteHandling/SiteSettingsDefinition.png)

**EXT:blog_example/Configuration/Sets/BlogExample/settings.definitions.yaml (Excerpt)**

```yaml
categories:
  BlogExample:
    label: 'Blog Example' # (1)
  BlogExample.templates:
    label: 'Templates' # (2)
    parent: BlogExample
  BlogExample.pages:
    label: 'Pages'
    parent: BlogExample

settings:
  blogExample.templateRootPath:  # (5)
    label: 'Templates' # (3)
    category: BlogExample.templates # (2)
    description: 'Path to template root'  # (4)
    type: string  # (6)
    default: 'EXT:blog_example/Resources/Private/Templates/'  # (7) + (8)
  blogExample.partialRootPath:
    label: 'Partials'
    category: BlogExample.templates
    description: 'Path to partial root'
    type: string
    default: 'EXT:blog_example/Resources/Private/Partials/'

```

See the complete example at
[settings.definitions.yaml (GitHub)](https://github.com/TYPO3-Documentation/blog_example/blob/main/Configuration/Sets/BlogExample/settings.definitions.yaml).

1.  Main category

    The label of the category is defined in *line 3* of the example code snippet.
    *Line 6 and 9* place two categories as subcategories into this category.
1.  Sub category

    The sub category is defined in *line 5 to 6*. *Line 14* locates the setting
    in this subcategory.
1.  Label

    Can be defined directly in the settings definition (*line 13*) or in a
    `labels.xlf` file.
1.  Description

    Can be defined directly in the settings definition (*line 15*) or in a
    `labels.xlf` file.
1.  Type

    *line 16*, for possible types see [Definition types](https://docs.typo3.org/permalink/t3coreapi:definition-types@13.4).
1.  Default value

    *line 23* the default value is displayed if the value of the settings was
    not overridden. If the value was overridden, it can be reset to the default.

    ![Screenshot showing the "Reset settings" button in the settings popup menu](../../Images/ManualScreenshots/SiteHandling/SiteSettingsReset.png)