---
title: "Site Management"
manual: "Getting Started"
version: "main"
permalink: "https://docs.typo3.org/permalink/t3start:site-management@main"
source: "FirstProject/SiteManagement/Index.rst"
modified: "2026-09-15T08:44:38+00:00"
---

# Site Management

> [!TIP]
> **Hint**
>
> If you choose "Create a basic site?" during setup you can skip this step.
>
> Proceed with chapter [Settings](https://docs.typo3.org/permalink/t3start:siterecords@main) to customize your
> installation.

**Table of contents**

-   [Create a new site configuration](https://docs.typo3.org/permalink/t3start:create-a-new-site-configuration@main)
-   [Edit the site configuration](https://docs.typo3.org/permalink/t3start:edit-the-site-configuration@main)
-   [Site management: Trouble shooting](https://docs.typo3.org/permalink/t3start:site-management-trouble-shooting@main)

## Create a new site configuration

> [!WARNING]
> **Attention**
>
> You can skip this step if you have already [created the root page](https://docs.typo3.org/permalink/t3start:create-root-page@main)
> in the root of the page tree. This will automatically generate a site
> configuration named after your page. Click the name of the page in the
> list of site configurations to [edit the site configuration](https://docs.typo3.org/permalink/t3start:edit-site-configuration@main).

Before creating a site configuration, you should have [created the root page](https://docs.typo3.org/permalink/t3start:create-root-page@main) of
your site in the page tree.

The site configuration is stored in a file called
`config/sites/my_site/config.yaml`. For your convenience, you can
edit this file using the backend module: **Sites > Setup**.

Available root pages should be listed in this module. Click
the button **Add new site configuration** next to the relevant
page to create a site configuration for it.

![Screenshot of the "Sites" module with no site created yet](NewSite.png)

## Edit the site configuration

You can now enter some basic information about the site.

The site identifier can be arbitrary, so we use "example_site" here. The
entry point should be a URL pointing to the web root. In this example, it is
a local URL generated by [DDEV](https://ddev.com/).

From the list of available sets, choose the set for your site package if you
have one. You can learn how to create a site package in the
[TYPO3 Sitepackage Tutorial](https://docs.typo3.org/m/typo3/tutorial-sitepackage/main/en-us/Index.html#start).

![Screenshot of the tab "General" of a newly created site configuration](NewSitePage1.png)

Since our set already depends on the set of `fluid_styled_content`, it is
not necessary to choose that set here.

![Screenshot of the tab "Languages" of a newly created site configuration](NewSitePageLanguage.png)

In the next two tabs, you can define error handling, such as a custom 404 page,
and static routes, for example, to a `robots.txt` file.

You can read more about [Site Handling](https://docs.typo3.org/m/typo3/reference-coreapi/main/en-us/ApiOverview/SiteHandling/Index.html#sitehandling) in
the reference "TYPO3 Explained".

After saving, a new file should be created in your project:

**config/sites/example_site/config.yaml**

```yaml
base: 'https://example-typo3131.ddev.site'
dependencies:
  - t3docs/site-package
languages:
  -
    title: English
    enabled: true
    locale: en_US
    hreflang: ''
    base: /en/
    websiteTitle: ''
    navigationTitle: English
    flag: en-us-gb
    languageId: 0
rootPageId: 7
websiteTitle: 'My example page'

```

## Site management: Trouble shooting

**Set of Site Package not available**

If the set of your site package is not available make sure, that the
site package extension is [Installed](https://docs.typo3.org/permalink/t3start:installing-extensions@main).

If the site package is installed but the site package set is still not
available the set or one of its dependencies might be corrupted.

![Screenshot of the "Site Configuration" module with an invalid site set displayed](InvalidSiteSet.png)

The site sets are cached. If you change the site set configuration and
see no difference, [clear the caches](https://docs.typo3.org/permalink/t3start:how-to-clear-cache@main).

**This site depends on invalid site sets**

If a set or one of its dependencies becomes corrupted after it has
already been added to a site configuration, an error box appears in
the table of configurations.

![Screenshot of the site configuration module with a site set that displays the error message "This site depends on invalid site sets".](InvalidDependency.png)

This can happen for example when you uninstall an extension on which
your site package depends. In this case install the extension again or
remove the dependency from your site package.

The site sets are cached. If you change the site set configuration and
see no difference, [clear the caches](https://docs.typo3.org/permalink/t3start:how-to-clear-cache@main).

**On saving TYPO3 keeps creating empty language configurations**

On saving the site settings TYPO3 keeps creating empty language
configurations.

This can happen if you deleted the language configuration with uid 0.
If you only need to use one language this one language has to have the
uid 0.

Edit the auto created language to fit your language needs.

![An empty language configuration in the site settings prevents saving](EmptyLanguage.png)

Sometimes it is easier to just edit the site configuration file:

```diff
 base: 'https://site-introduction.ddev.site/'
 languages:
   -
     title: English
     enabled: true
     locale: en-US
     hreflang: ''
     base: /
     websiteTitle: ''
     navigationTitle: ''
     flag: global
-    languageId: 1
+    languageId: 0
 rootPageId: 1
 websiteTitle: ''
```

Change the language id of the only language from 1 to 0.

**Malformed inline YAML string at line 17**

If you manually edited the site configuration and it contains a syntax
error, the whole backend module might stop working:

![Whoops, looks like something went wrong: Malformed inline YAML string at line 17.](MalformedYAML.png)

Fix or delete the affected site configuration by editing the file, for
example `config/sites/my-site/config.yaml`.

**No pages found**

If you see the following you cannot add any site configuration until
you fix the problem in the page tree:

![No pages found! Please add at least one page through the Layout module.](NoPagesFound.png)

If you have not created any pages yet,
[create a root page](https://docs.typo3.org/permalink/t3start:create-root-page@main)
first.

If you have created pages but still see the message, set the flag
"Use as Root Page" in the page properties, tab "Behavior" for the page
that should be the startpage of your site. A root page is displayed with
a globe icon in the page tree.

![Option "Use as Root Page" in the page properties.](MarkPageAsRootpage.png)