---
title: "TypoScript configuration of the Frontend Login"
manual: "Frontend Login"
version: "14.3"
permalink: "https://docs.typo3.org/permalink/typo3/cms-felogin:configuration-typoscript@14.3"
source: "Configuration/TypoScript.rst"
rendered: "2026-09-19T11:27:44+00:00"
---

# TypoScript configuration of the Frontend Login {#configuration-typoscript}

**Content on this page**

-   [TypoScript setup / FlexForm settings](https://docs.typo3.org/permalink/typo3/cms-felogin:typoscript-setup-flexform-settings@14.3)
-   [Example: Set the default storage page via TypoScript constant](https://docs.typo3.org/permalink/typo3/cms-felogin:example-set-the-default-storage-page-via-typoscript-constant@14.3)
-   [Example: Set the default storage page via TypoScript setup](https://docs.typo3.org/permalink/typo3/cms-felogin:example-set-the-default-storage-page-via-typoscript-setup@14.3)
-   [Example: Override the default storage page in the plugin's FlexForm](https://docs.typo3.org/permalink/typo3/cms-felogin:example-override-the-default-storage-page-in-the-plugin-s-flexform@14.3)

## TypoScript setup / FlexForm settings {#plugin-tx-felogin-login}

Most of these plugin settings can be set with the following methods, the top
bottom most taking precedence:

-   The corresponding [site set setting](https://docs.typo3.org/permalink/typo3/cms-felogin:configuration-site-set-settings@14.3)
-   The corresponding [TypoScript constant](https://docs.typo3.org/permalink/typo3/cms-felogin:configuration-examples-typoscript-constant@14.3)
-   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@14.3)
-   Setting from the [FlexForm of the plugin](https://docs.typo3.org/permalink/typo3/cms-felogin:plugin-tx-felogin-login@14.3)

See also [Example: Override the default storage page in the plugin's FlexForm](https://docs.typo3.org/permalink/typo3/cms-felogin:configuration-examples-flexform@14.3).

-   **showForgotPassword**

    -   *Type:* bool

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

    > [!IMPORTANT]
    > Be aware that having this option disabled also prevents the plugin to
    > display the forgot password form. For instance if you access the link
    > directly.

-   **showPermaLogin**

    -   *Type:* bool

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

-   **showLogoutFormAfterLogin**

    -   *Type:* bool

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

    > [!NOTE]
    > Setting this option will disable the redirect options!
    > Instead of redirecting the plugin will show the logout form.

-   **pages**

    -   *Type:* string
    -   *Site set setting:* [felogin.pid](https://docs.typo3.org/permalink/typo3/cms-felogin:confval-felogin-felogin-pid@14.3)
    -   *TypoScript Constant:* {$styles.content.loginform.pid}

    Define the User Storage Page with the Website User Records, using a
    comma separated list or a single value (page id).

-   **recursive**

    -   *Type:* int
    -   *Site set setting:* [felogin.recursive](https://docs.typo3.org/permalink/typo3/cms-felogin:confval-felogin-felogin-recursive@14.3)
    -   *TypoScript Constant:* {$styles.content.loginform.recursive}

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

-   **redirectMode**

    -   *Type:* string
    -   *Site set setting:* [felogin.redirectMode](https://docs.typo3.org/permalink/typo3/cms-felogin:confval-felogin-felogin-redirectmode@14.3)
    -   *TypoScript Constant:* {$styles.content.loginform.redirectMode}

    Comma separated list of redirect modes. Possible values:
    `groupLogin`, `userLogin`, `login`, `getpost`, `referer`,
    `refererDomains`, `loginError`, `logout`
    See section on redirect modes for details.

-   **redirectFirstMethod**

    -   *Type:* bool
    -   *Site set setting:* [felogin.redirectFirstMethod](https://docs.typo3.org/permalink/typo3/cms-felogin:confval-felogin-felogin-redirectfirstmethod@14.3)
    -   *TypoScript Constant:* {$styles.content.loginform.redirectFirstMethod}

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

-   **redirectPageLogin**

    -   *Type:* integer
    -   *Site set setting:* [felogin.redirectPageLogin](https://docs.typo3.org/permalink/typo3/cms-felogin:confval-felogin-felogin-redirectpagelogin@14.3)
    -   *TypoScript Constant:* {$styles.content.loginform.redirectPageLogin}

    Page id to redirect to after Login

-   **redirectPageLoginError**

    -   *Type:* integer
    -   *Site set setting:* [felogin.redirectPageLoginError](https://docs.typo3.org/permalink/typo3/cms-felogin:confval-felogin-felogin-redirectpageloginerror@14.3)
    -   *TypoScript Constant:* {$styles.content.loginform.redirectPageLoginError}

    Page id to redirect to after Login Error

-   **redirectPageLogout**

    -   *Type:* integer
    -   *Site set setting:* 1
    -   *TypoScript Constant:* {$styles.content.loginform.redirectPageLogout}

    Page id to redirect to after Logout

-   **redirectDisable**

    -   *Type:* bool
    -   *Site set setting:* [felogin.redirectPageLogout](https://docs.typo3.org/permalink/typo3/cms-felogin:confval-felogin-felogin-redirectpagelogout@14.3)
    -   *TypoScript Constant:* {$styles.content.loginform.redirectDisable}

    If set redirecting is disabled

-   **dateFormat**

    -   *Type:* date-conf
    -   *Site set setting:* [felogin.dateFormat](https://docs.typo3.org/permalink/typo3/cms-felogin:confval-felogin-felogin-dateformat@14.3)
    -   *TypoScript Constant:* Y-m-d H:i

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

-   **email_from**

    -   *Type:* string

    Email address used as sender of the change password emails

-   **email_fromName**

    -   *Type:* string

    Name used as sender of the change password emails

-   **email**

    -   **email.templateName**

        -   *Type:* string
        -   *Site set setting:* [felogin.email.templateName](https://docs.typo3.org/permalink/typo3/cms-felogin:confval-felogin-felogin-email-templatename@14.3)
        -   *TypoScript Constant:* {$styles.content.loginform.email.templateName}

        Template name for emails. Plaintext emails get the .txt file extension.

    -   **email.layoutRootPaths**

        -   *Type:* array
        -   *Site set setting:* [felogin.email.templateRootPath](https://docs.typo3.org/permalink/typo3/cms-felogin:confval-felogin-felogin-email-templaterootpath@14.3)
        -   *TypoScript Constant:* {$styles.content.loginform.email.layoutRootPath}

        Path to layout directory used for emails

    -   **email.templateRootPaths**

        -   *Type:* array
        -   *Site set setting:* [felogin.email.templateRootPath](https://docs.typo3.org/permalink/typo3/cms-felogin:confval-felogin-felogin-email-templaterootpath@14.3)
        -   *TypoScript Constant:* {$styles.content.loginform.email.templateRootPaths}

        Path to template directory used for emails

    -   **email.partialRootPaths**

        -   *Type:* array
        -   *Site set setting:* [felogin.email.partialRootPath](https://docs.typo3.org/permalink/typo3/cms-felogin:confval-felogin-felogin-email-partialrootpath@14.3)
        -   *TypoScript Constant:* {$styles.content.loginform.email.partialRootPaths}

        Path to partial directory used for emails

-   **forgotLinkHashValidTime**

    -   *Type:* integer
    -   *Site set setting:* [felogin.forgotLinkHashValidTime](https://docs.typo3.org/permalink/typo3/cms-felogin:confval-felogin-felogin-forgotlinkhashvalidtime@14.3)
    -   *TypoScript Constant:* {$styles.content.loginform.forgotLinkHashValidTime}

    Time in hours how long the link for forgot password is valid

-   **domains**

    -   *Type:* string

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

## Example: Set the default storage page via TypoScript constant {#configuration-examples-typoscript-constant}

You can use the [TypoScript provider](https://docs.typo3.org/m/typo3/reference-coreapi/main/en-us/ApiOverview/SiteHandling/SiteSets/Index.html#site-sets-typoscript)
or other means of [setting the TypoScript constants](https://docs.typo3.org/m/typo3/reference-typoscript/main/en-us/UsingSetting/Index.html#using-and-setting).

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

It is recommended to use the Settings for the "Frontend Login" site set
instead, as TypoScript constants will be phased out in the future.

**config/sites/MySite/constants.typoscript**

```typoscript
styles.content.loginform {
  pid = 42
  recursive = 255
}

```

## Example: Set the default storage page via TypoScript setup {#configuration-examples-typoscript}

In order to set the default storage page to a more dynamic value, use
the TypoScript setup. Use the [TypoScript provider](https://docs.typo3.org/m/typo3/reference-coreapi/main/en-us/ApiOverview/SiteHandling/SiteSets/Index.html#site-sets-typoscript)
or other means of ref:`setting the TypoScript setup <t3tsref:using-and-setting>`.

**config/sites/MySite/constants.typoscript**

```typoscript
[{$tx_my_extension.settings.feature1Enabled} == 1]
  plugin.tx_felogin_login.settings.pid = 123
[ELSE]
  plugin.tx_felogin_login.settings.pid = 42
[END]

```

## Example: Override the default storage page in the plugin's FlexForm {#configuration-examples-flexform}

If you set any FlexForm setting within the content element representing the
plugin to a **non-empty value** it will override any other setting not matter if it
is made via site settings, TypoScript constant ot TypoScript setup. Empty values
take no effect if a default was set by other means.

In the backend module **Content > Layout** edit the content element containing
the login form. Go to tab **Plugin** and sub tab **General**.
You should see a form similar to the following:

![A screenshot showing the "General" tab of the plugin settings](../Images/GeneralSettings.png)

Choose the desired page or pages in the field with label
**User Storage Page** (key [settings.pages](https://docs.typo3.org/permalink/typo3/cms-felogin:confval-typoscript-pages@14.3)).

> [!TIP]
> It is sometimes hard to determine, which label in the FlexForm corresponds
> to which key in the [FlexForm reference](https://docs.typo3.org/permalink/typo3/cms-felogin:plugin-tx-felogin-login@14.3).
>
> Turn on the [backend debug mode](https://docs.typo3.org/m/typo3/reference-coreapi/main/en-us/Configuration/Typo3ConfVars/BE.html#confval-globals-typo3-conf-vars-be-debug)
> to get a visual hint in the backend for the keys of the FlexForm field.

![A screenshot showing FlexForm Field with key \`settings.pages\`](../Images/FlexFormKey.png)
