---
title: "Settings"
manual: "Getting Started"
version: "14.3"
permalink: "https://docs.typo3.org/permalink/t3start:settings@14.3"
source: "FirstProject/Settings.rst"
rendered: "2026-10-01T16:42:59+00:00"
---

# Settings {#settings}

There are different possibilities to make settings to your installation or
parts of it.

-   [Global settings](https://docs.typo3.org/permalink/t3start:global-settings@14.3)
-   [Site handling](https://docs.typo3.org/permalink/t3start:site-handling@14.3)
-   [Page wide frontend definitions: TypoScript](https://docs.typo3.org/permalink/t3start:page-wide-frontend-definitions-typoscript@14.3)
-   [Page wide backend settings: Page TSconfig](https://docs.typo3.org/permalink/t3start:page-wide-backend-settings-page-tsconfig@14.3)

## Global settings {#settings-global}

Global settings can be made in the modules under the **Admin Tools** section,
which updates the `config/system/settings.php` file. Alternatively, settings can
be overridden manually in the `config/system/additional.php` file. Avoid making
manual changes to the first file mentioned, as it is auto-managed.

### Global extension settings {#settings-global-extension}

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

This module has been moved from Admin tools to
System.

Global settings for installed extensions, including some that are part of a
default installation, can be made in the
**System > Settings > Extension Configuration** submodule.

![Screenshot demonstration the location of the Extension Configuration in module "Settings"](../Images/ManualScreenshots/AdminTools/ExtensionConfiguration.png)

After opening the submodule, you can make your changes and hit "Save":

![Screenshot of the Extension Configuration submodule](../Images/ManualScreenshots/AdminTools/ExtensionConfigurationDetail.png)

> [!NOTE]
> The `config/system/settings.php` file has to be writable. If you keep
> it under version control, make sure to commit and push your changes.

## Site handling {#settings-site}

One TYPO3 installation can contain more then one site. Even if you only have one
site in your installation, important settings can be made in the Site Configuration.
Read more about this in the chapter
[Create a new site configuration](https://docs.typo3.org/permalink/t3start:siteconfiguration@14.3).

Site configurations are stored in a file called
`config/sites/my-site/config.yaml` and can be edited from the
**Sites > Setup** module. Each site must have a unique key, called
the "Site Identifier". For demonstration purposes, we use "my-site" here. The
Site Identifier is also used as the path for saving the configuration file.

![Screenshot demonstration field "Site Identifier" in a site configuration](../Images/ManualScreenshots/SiteManagement/SiteIdentifier.png)

Find detailed information in [TYPO3 Explained, Site handling](https://docs.typo3.org/m/typo3/reference-coreapi/14.3/en-us/ApiOverview/SiteHandling/Index.html#sitehandling).

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

You can edit site settings in the **Sites > Setup > Settings** module.
Changes are written to the `config/sites/my-site/settings.yaml` file. If you
keep this file under version control, you must commit and push the changes made
to this file.

![Screenshot of the Site Settings Overview](../Images/ManualScreenshots/SiteManagement/SiteSettingsOverview.png)

You can find more information about this editor in
[TYPO3 Explained, Site settings editor](https://docs.typo3.org/m/typo3/reference-coreapi/14.3/en-us/ApiOverview/SiteHandling/SiteSettingsEditor.html#site-settings-editor).

If site settings are available, refer to the documentation of the extension
offering them.

The following optional Core extensions offer site settings:

-   [`typo3/cms-fluid-styled-content`](https://packagist.org/packages/typo3/cms-fluid-styled-content):
    [Site set "Fluid Styled Content"](https://docs.typo3.org/c/typo3/cms-fluid-styled-content/14.3/en-us/Configuration/Sets/FluidStyledContent.html#site-set-fluid-styled-content).
    Commonly used in projects that do not depend on [`bk2k/bootstrap-package`](https://packagist.org/packages/bk2k/bootstrap-package).
-   [`typo3/cms-felogin`](https://packagist.org/packages/typo3/cms-felogin):
    [Settings for the "Frontend Login" site set](https://docs.typo3.org/c/typo3/cms-felogin/14.3/en-us/Configuration/SiteSets.html#configuration-site-set-settings).
    Used to offer a login for frontend users.
-   [`typo3/cms-indexed-search`](https://packagist.org/packages/typo3/cms-indexed-search):
    [Settings of the site set "Indexed Search"](https://docs.typo3.org/c/typo3/cms-indexed-search/14.3/en-us/Configuration/SiteSet/Index.html#site-set-settings).
    Used to display a search box and offer basic indexing of a page without the need
    for a Solr core, as would be required by [`apache-solr-for-typo3/solr`](https://packagist.org/packages/apache-solr-for-typo3/solr).
-   [`typo3/cms-seo`](https://packagist.org/packages/typo3/cms-seo):
    [Site sets settings of EXT:seo](https://docs.typo3.org/c/typo3/cms-seo/14.3/en-us/Configuration/Settings.html#configuration-site-set-settings).
    Used to improve meta tags and page titles, and provides an XML sitemap.

You can define custom site settings in your site package:
[TYPO3 Sitepackage Tutorial](https://docs.typo3.org/m/typo3/tutorial-sitepackage/14.3/en-us/Index.html#start).

For detailed information on this topic, see also
[TYPO3 Explained, Site settings](https://docs.typo3.org/m/typo3/reference-coreapi/14.3/en-us/ApiOverview/SiteHandling/SiteSettings.html#sitehandling-settings).

## Page wide frontend definitions: TypoScript {#settings-typoscript}

TypoScript is a configuration language used to configure both the frontend
output and the backend of a TYPO3 web site. TypoScript can be managed in a TypoScript
record, which can be found in the **Sites > TypoScript** module.

![](../Images/ManualScreenshots/SiteManagement/TypoScriptModule.png)

TypoScript affects the page on which it is defined, and any subpages. In most cases,
TypoScript is only defined on the root page of a site. In this case. the
settings made here affect the entire page.

You can also navigate between the different submodules by using the submodule menu:

![](../Images/ManualScreenshots/SiteManagement/TypoScriptModuleMenu.png)

See also the complete [TypoScript Reference](https://docs.typo3.org/m/typo3/reference-typoscript/14.3/en-us/Index.html#start).

## Page wide backend settings: Page TSconfig {#settings-page-tsconfig}

Read more about this topic in [Setting page TSconfig](https://docs.typo3.org/m/typo3/reference-typoscript/14.3/en-us/UsingSettingTSconfig/PageTSconfig.html#setting-page-tsconfig).