---
title: "Creating a new site configuration"
manual: "TYPO3 Explained"
version: "11.5"
permalink: "https://docs.typo3.org/permalink/t3coreapi:sitehandling-create-new@11.5"
source: "ApiOverview/SiteHandling/CreateNew.rst"
rendered: "2026-10-21T15:30:00+00:00"
---

# Creating a new site configuration {#sitehandling-create-new}

A new site configuration is automatically created for each
**new page on the rootlevel (pid = 0)** and each
**page with the "is_siteroot" flag set**.

To customize the automatically created site configuration,
go to the **Site Management > Sites** module.

![](../../Images/AutomaticScreenshots/SiteHandling/SiteHandlingCreateNewSite-1.png)

You can edit a site by clicking on the **Edit** icon (the pencil). If
for some reason no site configuration was created, there will be a button to
create one:

![](../../Images/AutomaticScreenshots/SiteHandling/SiteHandlingNoSite.png)

The site configuration form looks like this:

![](../../Images/AutomaticScreenshots/SiteHandling/SiteHandlingCreateNewSite-2.png)

It is recommended to change the following fields:

-   ****Site Identifier****

    The site identifier is the name of the folder within
    `<project-root>/config/sites/` that will hold your configuration
    file(s). When choosing an identifier, make sure to stick to ASCII, but for
    convenience you may also use `-`, `_` and `.`.

    Examples: `main-site` and `landing-page`.

-   ****Entry Point****

    Be as specific as you can for your sites without losing flexibility. So, if
    you have a choice between using `https://example.org`,
    `example.org` or `/`, then choose `https://example.org`.

    This makes the resolving of pages more reliable by minimizing the risk of
    conflicts with other sites.

If you need to use another domain in development, for example
`https://example.ddev.site`, it is recommended to use
[base variants](https://docs.typo3.org/permalink/t3coreapi:sitehandling-basevariants@11.5).

The next tab, **Languages**, lets you configure the default
language settings for your site. You can also add additional languages for
multilingual sites here.

These settings determine the default behavior - setting `direction` and
`lang` tags in frontend as well as locale settings.

![](../../Images/AutomaticScreenshots/SiteHandling/SiteHandlingCreateNewSite-3.png)

Check and correct all other settings as they will automatically used for
features like `hreflang` tags or displaying language flags in the
backend.

That is all that is required for a new site.

> [!TIP]
> Just by having a site configuration, you get readable page URLs out of
> the box. Read more about how to configure [routing](https://docs.typo3.org/permalink/t3coreapi:routing@11.5).

Learn more about [adding languages](https://docs.typo3.org/permalink/t3coreapi:sitehandling-addinglanguages@11.5),
[error handling](https://docs.typo3.org/permalink/t3coreapi:sitehandling-errorhandling@11.5) and [routing](https://docs.typo3.org/permalink/t3coreapi:routing@11.5)
in the corresponding chapters.