---
title: "The site folder config/sites/ / typo3conf/sites/"
manual: "TYPO3 Explained"
version: "main"
permalink: "https://docs.typo3.org/permalink/t3coreapi:site-folder@main"
source: "Administration/DirectoryStructure/SiteFolder.rst"
rendered: "2026-09-17T14:31:42+00:00"
---

# The site folder `config/sites/` / `typo3conf/sites/` {#the-site-folder-config-sites-typo3conf-sites}

The site folder (`config/sites/my-site` in Composer-based installations,
`typo3conf/sites/my-site` in Classic mode installations) **must** contain the
following file:

-   **config.yaml**

    -   *Scope:* site
    -   *Path (Composer):* config/sites/my-site/config.yaml
    -   *Path (Classic):* typo3conf/sites/my-site/config.yaml

    Contains the site configuration. See chapter
    [Site handling](https://docs.typo3.org/permalink/t3coreapi:sitehandling)
    for details.

    The file is automatically created if you use the
    **Sites > Setup** module to
    [create a new site configuration](https://docs.typo3.org/permalink/t3coreapi:sitehandling-create-new).

    The name of the folder is editable as **Site Identifier** in the site
    configuration form.

**Optional files in the site folder**

-   [Site settings settings.yaml in the site folder](https://docs.typo3.org/permalink/t3coreapi:site-settings-settings-yaml-in-the-site-folder@main)
-   [The site as frontend TypoScript provider](https://docs.typo3.org/permalink/t3coreapi:the-site-as-frontend-typoscript-provider@main)
-   [Page TSconfig in the site folder](https://docs.typo3.org/permalink/t3coreapi:page-tsconfig-in-the-site-folder@main)
-   [Additional configuration files in the site folder](https://docs.typo3.org/permalink/t3coreapi:additional-configuration-files-in-the-site-folder@main)

## Site settings `settings.yaml` in the site folder {#site-settings-settings-yaml-in-the-site-folder}

-   **settings.yaml**

    -   *Scope:* site
    -   *Path (Composer):* config/sites/my-site/settings.yaml
    -   *Path (Classic):* typo3conf/sites/my-site/settings.yaml

    This file stores all changes that where made to the site settings using the
    backend module **Sites > Setup > Settings**. It overrides the
    settings from all included site sets, including the set of the site package.

    > [!NOTE]
    > **See also**
    >
    > -   [Site settings](https://docs.typo3.org/permalink/t3coreapi:sitehandling-settings).
    > -   [Module Sites > Setup > Settings](https://docs.typo3.org/permalink/t3coreapi:site-settings-editor)

## The site as frontend TypoScript provider {#the-site-as-frontend-typoscript-provider}

If the site should be used as TypoScript provider
(see [Site as a TypoScript provider](https://docs.typo3.org/m/typo3/reference-typoscript/main/en-us/UsingSetting/SiteTypoScriptProvider.html#typoscript-site-sets-site))
it can contain the following files:

-   **constants.typoscript**

    -   *Scope:* site
    -   *Path (Composer):* config/sites/my-site/constants.typoscript
    -   *Path (Classic):* typo3conf/sites/my-site/constants.typoscript

    Contains the TypoScript constants of a site.

-   **setup.typoscript**

    -   *Scope:* site
    -   *Path (Composer):* config/sites/my-site/setup.typoscript
    -   *Path (Classic):* typo3conf/sites/my-site/setup.typoscript

    Contains the TypoScript setup of a site.

## Page TSconfig in the site folder {#page-tsconfig-in-the-site-folder}

-   **page.tsconfig**

    -   *Scope:* site
    -   *Path (Composer):* config/sites/my-site/page.tsconfig
    -   *Path (Classic):* typo3conf/sites/my-site/page.tsconfig

    Page TSconfig in this file is automatically loaded within the site scope.
    See also [Page TSconfig on site level](https://docs.typo3.org/permalink/t3tsref:include-static-page-tsconfig-per-site).

## Additional configuration files in the site folder {#additional-configuration-files-in-the-site-folder}

The site folder may also contain the following file:

-   **csp.yaml**

    -   *Scope:* site
    -   *Path (Composer):* config/sites/my-site/csp.yaml
    -   *Path (Classic):* typo3conf/sites/my-site/csp.yaml

    Used for a
    [site-specific Content Security Policy](https://docs.typo3.org/permalink/t3coreapi:content-security-policy-site@main).