---
title: "Site set configuration of the Frontend Login"
manual: "Frontend Login"
version: "main"
permalink: "https://docs.typo3.org/permalink/typo3/cms-felogin:configuration-site-sets-include@main"
source: "Configuration/SiteSets.rst"
rendered: "2026-09-19T11:14:22+00:00"
---

# Site set configuration of the Frontend Login {#configuration-site-sets-include}

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

Site sets were added.

The system extension [`typo3/cms-felogin`](https://packagist.org/packages/typo3/cms-felogin) provides the site
set "Frontend Login".

The different methods of setting are taking precedence in the following order:

-   The corresponding [site set setting](https://docs.typo3.org/permalink/typo3/cms-felogin:configuration-site-set-settings@main)
-   The corresponding [TypoScript constant](https://docs.typo3.org/permalink/typo3/cms-felogin:configuration-examples-typoscript-constant@main)
-   Value set in [TypoScript setup](https://docs.typo3.org/m/typo3/reference-typoscript/main/en-us/UsingSetting/Index.html#using-and-setting) in the
    scope [plugin.tx_felogin_login.settings](https://docs.typo3.org/permalink/typo3/cms-felogin:plugin-tx-felogin-login@main)
-   Setting from the [FlexForm of the plugin](https://docs.typo3.org/permalink/typo3/cms-felogin:plugin-tx-felogin-login@main)

**Content on this page**

-   [Include the site set](https://docs.typo3.org/permalink/typo3/cms-felogin:include-the-site-set@main)
-   [Settings for the "Frontend Login" site set](https://docs.typo3.org/permalink/typo3/cms-felogin:settings-for-the-frontend-login-site-set@main)
-   [Migration from TypoScript setup settings to site settings](https://docs.typo3.org/permalink/typo3/cms-felogin:migration-from-typoscript-setup-settings-to-site-settings@main)
-   [Example: Set the user storage page using the site set settings](https://docs.typo3.org/permalink/typo3/cms-felogin:example-set-the-user-storage-page-using-the-site-set-settings@main)

## Include the site set {#configuration-site-set}

Include the site set "Frontend Login" via the [site set in the site
configuration](https://docs.typo3.org/m/typo3/reference-coreapi/main/en-us/ApiOverview/SiteHandling/SiteSets/Index.html#site-sets) or the custom
[site package's site set](https://docs.typo3.org/m/typo3/tutorial-sitepackage/main/en-us/SiteSets/Index.html#site_set).

![](../Images/SiteSet.png)

This will change your site configuration file as follows:

**config/sites/my-site/config.yaml (diff)**

```diff
  base: 'https://example.com/'
  rootPageId: 1
  dependencies:
+   - typo3/felogin
    - typo3/fluid-styled-content-css

```

If your site has a custom [site package](https://docs.typo3.org/m/typo3/tutorial-sitepackage/main/en-us/Index.html#start), you
can also add the "Frontend Login" set as dependency in your site set's configuration:

**EXT:my_site_package/Configuration/Sets/MySite/config.yaml (diff)**

```diff
 name: my-vendor/my-site-package
 label: My Site Package Set
 settings:
   website:
     background:
       color: '#386492'
 dependencies:
+  - typo3/felogin
   - typo3/fluid-styled-content-css

```

## Settings for the "Frontend Login" site set {#configuration-site-set-settings}

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

These settings were added with the site sets in TYPO3 v13.1.

See also: [Example: Set the user storage page using the site set settings](https://docs.typo3.org/permalink/typo3/cms-felogin:configuration-examples-felogin-pid@main).

If you plan to migrate from TypoScript setup settings to site settings see
[Migration from TypoScript setup settings to site settings](https://docs.typo3.org/permalink/typo3/cms-felogin:configuration-migration@main).

These settings can be adjusted in the [Settings editor](https://docs.typo3.org/permalink/typo3/cms-felogin:settings-editor@main).

**Settings of "Frontend Login"**

-   **felogin**

    -   *Label:* Frontend Login

    -   **felogin.pid**

        -   *Type:* `string`
        -   *Default:* `"0"`
        -   *Label:* User Storage Page
        -   *Category:* Frontend Login

        Define the Storage Folder with the Website User Records, using a comma separated list or single value

    -   **felogin.recursive**

        -   *Type:* `string`
        -   *Default:* `"0"`
        -   *Label:* Recursive
        -   *Enum:* \[ "0", "1", "2", "3", "4", "255" \]
        -   *Category:* Frontend Login

        If set, also subfolder at configured recursive levels of the User Storage Page will be used

    -   **felogin.showForgotPassword**

        -   *Type:* `bool`
        -   *Default:* `false`
        -   *Label:* Display Password Recovery Link
        -   *Category:* Frontend Login

        If set, the section in the template to display the link to the forgot password dialog is visible.

    -   **felogin.showPermaLogin**

        -   *Type:* `bool`
        -   *Default:* `false`
        -   *Label:* Display Remember Login Option
        -   *Category:* Frontend Login

        If set, the section in the template to display the option to remember the login (with a cookie) is visible.

    -   **felogin.showLogoutFormAfterLogin**

        -   *Type:* `bool`
        -   *Default:* `false`
        -   *Label:* Disable redirect after successful login, but display logout-form
        -   *Category:* Frontend Login

        If set, the logout form will be displayed immediately after successful login.

    -   **felogin.emailFrom**

        -   *Type:* `string`
        -   *Label:* Email Sender Address
        -   *Category:* Frontend Login

        email address used as sender of the change password emails

    -   **felogin.emailFromName**

        -   *Type:* `string`
        -   *Label:* Email Sender Name
        -   *Category:* Frontend Login

        Name used as sender of the change password emails

    -   **felogin.replyToEmail**

        -   *Type:* `string`
        -   *Label:* Reply-to email Address
        -   *Category:* Frontend Login

        Reply-to address used in the change password emails

    -   **felogin.dateFormat**

        -   *Type:* `string`
        -   *Default:* `"Y-m-d H:i"`
        -   *Label:* Date format
        -   *Category:* Frontend Login

        Format for the link is valid until message (forgot password email)

    -   **felogin.email.layoutRootPath**

        -   *Type:* `string`
        -   *Label:* Layout root path
        -   *Category:* Frontend Login

        Path to layout directory used for emails

    -   **felogin.email.templateRootPath**

        -   *Type:* `string`
        -   *Default:* `"EXT:felogin/Resources/Private/Email/Templates/"`
        -   *Label:* Template root path
        -   *Category:* Frontend Login

        Path to template directory used for emails

    -   **felogin.email.partialRootPath**

        -   *Type:* `string`
        -   *Label:* Partial root path
        -   *Category:* Frontend Login

        Path to partial directory used for emails

    -   **felogin.email.templateName**

        -   *Type:* `string`
        -   *Default:* `"PasswordRecovery"`
        -   *Label:* Template name for emails.
        -   *Category:* Frontend Login

        HTML emails get the .html file extension, plaintext emails get the .txt file extension.

    -   **felogin.redirectMode**

        -   *Type:* `string`
        -   *Label:* Redirect Mode
        -   *Category:* Frontend Login

        Comma separated list of redirect modes.\\
        Possible values: groupLogin, userLogin, login, getpost, referer, refererDomains, loginError, logout.\\
        Warning: redirects only work if neither the plugin nor the page it is displayed on are set to \`hide at login\`.

    -   **felogin.redirectFirstMethod**

        -   *Type:* `bool`
        -   *Default:* `false`
        -   *Label:* Use First Supported Mode from Selection
        -   *Category:* Frontend Login

        If set the first method from redirectMode which is possible will be used

    -   **felogin.redirectPageLogin**

        -   *Type:* `page`
        -   *Default:* `0`
        -   *Label:* After Successful Login Redirect to Page
        -   *Category:* Frontend Login

        Page id to redirect to after Login

    -   **felogin.redirectPageLoginError**

        -   *Type:* `page`
        -   *Default:* `0`
        -   *Label:* After Failed Login Redirect to Page
        -   *Category:* Frontend Login

        Page id to redirect to after Login Error

    -   **felogin.redirectPageLogout**

        -   *Type:* `page`
        -   *Default:* `0`
        -   *Label:* After Logout Redirect to Page
        -   *Category:* Frontend Login

        Page id to redirect to after Logout

    -   **felogin.redirectDisable**

        -   *Type:* `bool`
        -   *Default:* `false`
        -   *Label:* Disable Redirect
        -   *Category:* Frontend Login

        If set redirecting is disabled

    -   **felogin.forgotLinkHashValidTime**

        -   *Type:* `int`
        -   *Default:* `12`
        -   *Label:* Time in hours how long the link for forgot password is valid
        -   *Category:* Frontend Login

        How many hours the link for forgot password is valid

    -   **felogin.domains**

        -   *Type:* `string`
        -   *Label:* Allowed Referrer-Redirect-Domains
        -   *Category:* Frontend Login

        Comma separated list of domains which are allowed for the referrer redirect mode

    -   **felogin.view.templateRootPath**

        -   *Type:* `string`
        -   *Label:* Path to template root (frontend)
        -   *Category:* Frontend Login

        Path to template directory used for the plugin in the frontend. Extends the default template location.

    -   **felogin.view.partialRootPath**

        -   *Type:* `string`
        -   *Label:* Path to template partials (frontend)
        -   *Category:* Frontend Login

        Path to partial directory for the plugin in the frontend. Extends the default partial location.

    -   **felogin.view.layoutRootPath**

        -   *Type:* `string`
        -   *Label:* Path to template layouts (frontend)
        -   *Category:* Frontend Login

        Path to layout directory used for the plugin in the frontend. Can be used to introduce a custom layout.

## Migration from TypoScript setup settings to site settings {#configuration-migration}

The site settings are named like the TypoScript constants used before
site sets. However the TypoScript constants are not always named the same
like the [TypoScript setup settings](https://docs.typo3.org/permalink/typo3/cms-felogin:plugin-tx-felogin-login@main).

For each [TypoScript setup / FlexForm setting](https://docs.typo3.org/permalink/typo3/cms-felogin:plugin-tx-felogin-login@main)
we list the corresponding site set setting in the overview table of the configuration values.

For example, the setting [felogin.pid](https://docs.typo3.org/permalink/typo3/cms-felogin:confval-felogin-felogin-pid@main) sets
setting [pages](https://docs.typo3.org/permalink/typo3/cms-felogin:pages@main).

Bear that in mind when migrating from TypoScript setup to site set settings.

## Example: Set the user storage page using the site set settings {#configuration-examples-felogin-pid}

After you [included the site set](https://docs.typo3.org/permalink/typo3/cms-felogin:configuration-site-set@main) you can use
the [site set settings](https://docs.typo3.org/permalink/typo3/cms-felogin:configuration-site-set-settings@main) to configure
the frontend login plugin's behaviour and layout site-wide.

See also [Adding site settings](https://docs.typo3.org/m/typo3/reference-coreapi/main/en-us/ApiOverview/SiteHandling/SiteSettings.html#sitehandling-settings-add).

You can add the settings to your [Site settings](https://docs.typo3.org/m/typo3/reference-coreapi/main/en-us/ApiOverview/SiteHandling/SiteSettings.html#sitehandling-settings)
or to the settings of your
[custom site package extension](https://docs.typo3.org/m/typo3/tutorial-sitepackage/main/en-us/Index.html#start).

To add the settings to your site settings, edit the file
`config/sites/<my_site>/settings.yaml` in Composer-based installations
or `typo3conf/sites/<my_site>/settings.yaml` in legacy installations. If
the file does not exist yet, create one. Use the setting
[felogin.pid](https://docs.typo3.org/permalink/typo3/cms-felogin:confval-felogin-felogin-pid@main) to set the storage folder. If
its subfolders should also be included, additionally use setting
[felogin.recursive](https://docs.typo3.org/permalink/typo3/cms-felogin:confval-felogin-felogin-recursive@main).

**config/sites/\<my_site>/settings.yaml | typo3conf/sites/\<my_site>/settings.yaml**

```yaml
felogin:
  pid: 42
  recursive: 255

```
