---
title: "BE - backend configuration"
manual: "TYPO3 Explained"
version: "11.5"
permalink: "https://docs.typo3.org/permalink/t3coreapi:typo3confvars-be@11.5"
source: "Configuration/Typo3ConfVars/BE.rst"
rendered: "2026-10-21T15:30:00+00:00"
---

> [!WARNING]
> **Attention**
>
> TYPO3 v11 has reached end-of-life as of October 31th 2024 and
> is no longer being maintained. Use the version switcher on the top
> left of this page to select documentation for a supported version of TYPO3.
>
> Need more time before upgrading?
> You can purchase Extended Long Term Support (ELTS) for TYPO3 v11 here:
> [TYPO3 ELTS](https://typo3.com/services/extended-support-elts).

# BE - backend configuration {#typo3confvars-be}

The following configuration variables can be used to configure settings for
the TYPO3 backend:

-   [languageDebug](https://docs.typo3.org/permalink/t3coreapi:languagedebug@11.5)
-   [fileadminDir](https://docs.typo3.org/permalink/t3coreapi:fileadmindir@11.5)
-   [lockRootPath](https://docs.typo3.org/permalink/t3coreapi:lockrootpath@11.5)
-   [userHomePath](https://docs.typo3.org/permalink/t3coreapi:userhomepath@11.5)
-   [groupHomePath](https://docs.typo3.org/permalink/t3coreapi:grouphomepath@11.5)
-   [userUploadDir](https://docs.typo3.org/permalink/t3coreapi:useruploaddir@11.5)
-   [warning_email_addr](https://docs.typo3.org/permalink/t3coreapi:warning-email-addr@11.5)
-   [warning_mode](https://docs.typo3.org/permalink/t3coreapi:warning-mode@11.5)
-   [passwordReset](https://docs.typo3.org/permalink/t3coreapi:passwordreset@11.5)
-   [passwordResetForAdmins](https://docs.typo3.org/permalink/t3coreapi:passwordresetforadmins@11.5)
-   [requireMfa](https://docs.typo3.org/permalink/t3coreapi:requiremfa@11.5)
-   [recommendedMfaProvider](https://docs.typo3.org/permalink/t3coreapi:recommendedmfaprovider@11.5)
-   [loginRateLimit](https://docs.typo3.org/permalink/t3coreapi:loginratelimit@11.5)
-   [loginRateLimitInterval](https://docs.typo3.org/permalink/t3coreapi:loginratelimitinterval@11.5)
-   [loginRateLimitIpExcludeList](https://docs.typo3.org/permalink/t3coreapi:loginratelimitipexcludelist@11.5)
-   [lockIP](https://docs.typo3.org/permalink/t3coreapi:lockip@11.5)
-   [lockIPv6](https://docs.typo3.org/permalink/t3coreapi:lockipv6@11.5)
-   [sessionTimeout](https://docs.typo3.org/permalink/t3coreapi:sessiontimeout@11.5)
-   [IPmaskList](https://docs.typo3.org/permalink/t3coreapi:ipmasklist@11.5)
-   [lockSSL](https://docs.typo3.org/permalink/t3coreapi:lockssl@11.5)
-   [lockSSLPort](https://docs.typo3.org/permalink/t3coreapi:locksslport@11.5)
-   [cookieDomain](https://docs.typo3.org/permalink/t3coreapi:cookiedomain@11.5)
-   [cookieName](https://docs.typo3.org/permalink/t3coreapi:cookiename@11.5)
-   [cookieSameSite](https://docs.typo3.org/permalink/t3coreapi:cookiesamesite@11.5)
-   [Removed: loginSecurityLevel](https://docs.typo3.org/permalink/t3coreapi:removed-loginsecuritylevel@11.5)
-   [showRefreshLoginPopup](https://docs.typo3.org/permalink/t3coreapi:showrefreshloginpopup@11.5)
-   [adminOnly](https://docs.typo3.org/permalink/t3coreapi:adminonly@11.5)
-   [disable_exec_function](https://docs.typo3.org/permalink/t3coreapi:disable-exec-function@11.5)
-   [compressionLevel](https://docs.typo3.org/permalink/t3coreapi:compressionlevel@11.5)
-   [installToolPassword](https://docs.typo3.org/permalink/t3coreapi:installtoolpassword@11.5)
-   [checkStoredRecords](https://docs.typo3.org/permalink/t3coreapi:checkstoredrecords@11.5)
-   [checkStoredRecordsLoose](https://docs.typo3.org/permalink/t3coreapi:checkstoredrecordsloose@11.5)
-   [defaultUserTSconfig](https://docs.typo3.org/permalink/t3coreapi:defaultusertsconfig@11.5)
-   [defaultPageTSconfig](https://docs.typo3.org/permalink/t3coreapi:defaultpagetsconfig@11.5)
-   [defaultPermissions](https://docs.typo3.org/permalink/t3coreapi:defaultpermissions@11.5)
-   [defaultUC](https://docs.typo3.org/permalink/t3coreapi:defaultuc@11.5)
-   [customPermOptions](https://docs.typo3.org/permalink/t3coreapi:custompermoptions@11.5)
-   [fileDenyPattern](https://docs.typo3.org/permalink/t3coreapi:filedenypattern@11.5)
-   [interfaces](https://docs.typo3.org/permalink/t3coreapi:interfaces@11.5)
-   [explicitADmode](https://docs.typo3.org/permalink/t3coreapi:explicitadmode@11.5)
-   [flexformForceCDATA](https://docs.typo3.org/permalink/t3coreapi:flexformforcecdata@11.5)
-   [versionNumberInFilename](https://docs.typo3.org/permalink/t3coreapi:versionnumberinfilename@11.5)
-   [debug](https://docs.typo3.org/permalink/t3coreapi:debug@11.5)
-   [toolbarItems](https://docs.typo3.org/permalink/t3coreapi:toolbaritems@11.5)
-   [HTTP](https://docs.typo3.org/permalink/t3coreapi:http@11.5)
-   [passwordHashing](https://docs.typo3.org/permalink/t3coreapi:passwordhashing@11.5)

> [!NOTE]
> The configuration values listed here are keys in the global PHP array
> `$GLOBALS['TYPO3_CONF_VARS']['BE']`.
>
> This variable can be set in one of the following files:
>
> -   [typo3conf/LocalConfiguration.php](https://docs.typo3.org/permalink/t3coreapi:typo3confvars-localconfiguration@11.5)
> -   [typo3conf/AdditionalConfiguration.php](https://docs.typo3.org/permalink/t3coreapi:typo3confvars-additionalconfiguration@11.5)

## languageDebug {#typo3confvars-be-languagedebug}

-   **$GLOBALS\['TYPO3_CONF_VARS'\]\['BE'\]\['languageDebug'\]**

    -   *type:* bool
    -   *Default:* false

    If enabled, language labels will be shown with additional debug information.

## fileadminDir {#typo3confvars-be-fileadmindir}

-   **$GLOBALS\['TYPO3_CONF_VARS'\]\['BE'\]\['fileadminDir'\]**

    -   *type:* text
    -   *Default:* 'fileadmin/'

    Path to the primary directory of files for editors. This is relative to
    the public web dir. DefaultStorage will be created with that configuration.
    Do not access manually but via
    `\TYPO3\CMS\Core\Resource\ResourceFactory::getDefaultStorage().`

## lockRootPath {#typo3confvars-be-lockrootpath}

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

This option has been extended to support an array of root path prefixes to
allow for multiple storages to be listed (a string was expected before).It is suggested to use the new array-based syntax, which will be applied
automatically once this setting is updated via Install Tool configuration
wizard. Migration:// Before
$GLOBALS['TYPO3_CONF_VARS']['BE']['lockRootPath'] = '/var/extra-storage';

// After
$GLOBALS['TYPO3_CONF_VARS']['BE']['lockRootPath'] =  [
    '/var/extra-storage1/',
    '/var/extra-storage2/',
];See also the security bulletin "Path Traversal in TYPO3 File Abstraction Layer Storages".

-   **$GLOBALS\['TYPO3_CONF_VARS'\]\['BE'\]\['lockRootPath'\]**

    -   *type:* array of file paths
    -   *Default:* `[]`

    These absolute paths are used to evaluate, if paths outside of the project
    path should be allowed. This restriction also applies for the local driver
    of the [File Abstraction Layer](https://docs.typo3.org/permalink/t3coreapi:fal@11.5).

    > [!WARNING]
    > **Attention**
    >
    > Trailing slashes are enforced automatically.

## userHomePath {#typo3confvars-be-userhomepath}

-   **$GLOBALS\['TYPO3_CONF_VARS'\]\['BE'\]\['userHomePath'\]**

    -   *type:* text
    -   *Default:* ''

    Combined folder identifier of the directory where TYPO3 backend users have
    their home-dirs. A combined folder identifier looks like this:
    `[storageUid]:[folderIdentifier]`. For Example `2:users/`.
    A home for backend user 2 would be: `2:users/2/`. Ending slash required!

## groupHomePath {#typo3confvars-be-grouphomepath}

-   **$GLOBALS\['TYPO3_CONF_VARS'\]\['BE'\]\['groupHomePath'\]**

    -   *type:* text
    -   *Default:* ''

    Combined folder identifier of the directory where TYPO3 backend groups have
    their home-dirs. A combined folder identifier looks like this:
    `[storageUid]:[folderIdentifier]`. For example `2:groups/`.
    A home for backend group 1 would be: `2:groups/1/`. Ending slash required!

## userUploadDir {#typo3confvars-be-useruploaddir}

-   **$GLOBALS\['TYPO3_CONF_VARS'\]\['BE'\]\['userUploadDir'\]**

    -   *type:* text
    -   *Default:* ''

    Suffix to the user home dir which is what gets mounted in TYPO3. For example
    if the user dir is `../123_user/`  and this value
    is `/upload`  then `../123_user/upload` gets mounted.

## warning_email_addr {#typo3confvars-be-warning-email-addr}

-   **$GLOBALS\['TYPO3_CONF_VARS'\]\['BE'\]\['warning_email_addr'\]**

    -   *type:* text
    -   *Default:* ''

    Email address that will receive notifications whenever an attempt to
    login to the Install Tool is made. This address will also receive warnings
    whenever more than 3 failed backend login attempts (regardless of user)
    are detected within an hour.

    Have also a look into the [security guidelines](https://docs.typo3.org/permalink/t3coreapi:security-global-typo3-options-warning-email-addr@11.5).

## warning_mode {#typo3confvars-be-warning-mode}

-   **$GLOBALS\['TYPO3_CONF_VARS'\]\['BE'\]\['warning_mode'\]**

    -   *type:* int
    -   *Default:*
    -   *allowedValues:*

        -   **0:**

            Default: Do not send notification-emails upon backend-login

        -   **1:**

            Send a notification-email every time a backend user logs in

        -   **2:**

            Send a notification-email every time an **admin** backend user logs in

    Send emails to `warning_email_addr`  upon backend-login

    Have also a look into the [security guidelines](https://docs.typo3.org/permalink/t3coreapi:security-global-typo3-options-warning-mode@11.5).

## passwordReset {#typo3confvars-be-passwordreset}

-   **$GLOBALS\['TYPO3_CONF_VARS'\]\['BE'\]\['passwordReset'\]**

    -   *type:* bool
    -   *Default:* true

    Enable password reset functionality on the backend login for TYPO3 Backend
    users. Can be disabled for systems where only LDAP or OAuth login is allowed.

    Password reset will then still work on CLI and for admins in the backend.

## passwordResetForAdmins {#typo3confvars-be-passwordresetforadmins}

-   **$GLOBALS\['TYPO3_CONF_VARS'\]\['BE'\]\['passwordResetForAdmins'\]**

    -   *type:* bool
    -   *Default:* true

    Enable password reset functionality for TYPO3 Administrators. This will
    affect all places such as backend login or CLI. Disable this option for
    increased security.

## requireMfa {#typo3confvars-be-requiremfa}

-   **$GLOBALS\['TYPO3_CONF_VARS'\]\['BE'\]\['requireMfa'\]**

    -   *type:* int
    -   *Default:*
    -   *allowedValues:*

        -   **0:**

            Default: Do not require multi-factor authentication

        -   **1:**

            Require multi-factor authentication for all users

        -   **2:**

            Require multi-factor authentication only for non-admin users

        -   **3:**

            Require multi-factor authentication only for admin users

        -   **4:**

            Require multi-factor authentication only for system maintainers

    Define users which should be required to set up
    [multi-factor authentication](https://docs.typo3.org/permalink/t3coreapi:multi-factor-authentication@11.5).

## recommendedMfaProvider {#typo3confvars-be-recommendedmfaprovider}

-   **$GLOBALS\['TYPO3_CONF_VARS'\]\['BE'\]\['recommendedMfaProvider'\]**

    -   *type:* text
    -   *Default:* 'totp'

    Set the identifier of the
    [multi-factor authentication provider](https://docs.typo3.org/permalink/t3coreapi:multi-factor-authentication-included-providers@11.5),
    recommended for all users.

## loginRateLimit {#typo3confvars-be-loginratelimit}

-   **$GLOBALS\['TYPO3_CONF_VARS'\]\['BE'\]\['loginRateLimit'\]**

    -   *type:* int
    -   *Default:* 5

    Maximum amount of login attempts for the time interval in
    [\[BE\]\[loginRateLimitInterval\]](https://docs.typo3.org/permalink/t3coreapi:typo3confvars-be-loginratelimitinterval@11.5),
    before further login requests will be denied. Setting this value to
    `"0"` will disable login rate limiting.

## loginRateLimitInterval {#typo3confvars-be-loginratelimitinterval}

-   **$GLOBALS\['TYPO3_CONF_VARS'\]\['BE'\]\['loginRateLimitInterval'\]**

    -   *type:* string, PHP relative format
    -   *Default:* '15 minutes'
    -   *allowedValues:* '1 minute', '5 minutes', '15 minutes', '30 minutes'

    Allowed time interval for the configured rate limit. Individual values
    using
    [PHP relative formats](https://www.php.net/manual/de/datetime.formats.relative.php)
    can be set in `AdditionalConfiguration.php`.

## loginRateLimitIpExcludeList {#typo3confvars-be-loginratelimitipexcludelist}

-   **$GLOBALS\['TYPO3_CONF_VARS'\]\['BE'\]\['loginRateLimitIpExcludeList'\]**

    -   *type:* string
    -   *Default:* ''

    IP-numbers (with `*`-wildcards) that are excluded from rate limiting.
    Syntax similar to [\[BE\]\[IPmaskList\]](https://docs.typo3.org/permalink/t3coreapi:typo3confvars-be-ipmasklist@11.5).
    An empty value disables the exclude list check.

## lockIP {#typo3confvars-be-lockip}

-   **$GLOBALS\['TYPO3_CONF_VARS'\]\['BE'\]\['lockIP'\]**

    -   *type:* int
    -   *Default:*
    -   *allowedValues:*

        -   **0:**

            Default: Do not lock Backend User sessions to their IP address at all

        -   **1:**

            Use the first part of the editors IPv4 address (for example "192.") as part of the session locking of Backend Users

        -   **2:**

            Use the first two parts of the editors IPv4 address (for example "192.168") as part of the session locking of Backend Users

        -   **3:**

            Use the first three parts of the editors IPv4 address (for example "192.168.13") as part of the session locking of Backend Users

        -   **4:**

            Use the editors full IPv4 address (for example "192.168.13.84") as part of the session locking of Backend Users (highest security)

    Session IP locking for backend users. See [\[FE\]\[lockIP\]](https://docs.typo3.org/permalink/t3coreapi:typo3confvars-fe-lockip@11.5) for details.

    Have also a look into the [security guidelines](https://docs.typo3.org/permalink/t3coreapi:security-global-typo3-options-lockip@11.5).

## lockIPv6 {#typo3confvars-be-lockipv6}

-   **$GLOBALS\['TYPO3_CONF_VARS'\]\['BE'\]\['lockIPv6'\]**

    -   *type:* int
    -   *Default:*
    -   *allowedValues:*

        -   **0:**

            Default: Do not lock Backend User sessions to their IP address at all

        -   **1:**

            Use the first block (16 bits) of the editors IPv6 address (for example "2001:") as part of the session locking of Backend Users

        -   **2:**

            Use the first two blocks (32 bits) of the editors IPv6 address (for example "2001:0db8") as part of the session locking of Backend Users

        -   **3:**

            Use the first three blocks (48 bits) of the editors IPv6 address (for example "2001:0db8:85a3") as part of the session locking of Backend Users

        -   **4:**

            Use the first four blocks (64 bits) of the editors IPv6 address (for example "2001:0db8:85a3:08d3") as part of the session locking of Backend Users

        -   **5:**

            Use the first five blocks (80 bits) of the editors IPv6 address (for example "2001:0db8:85a3:08d3:1319") as part of the session locking of Backend Users

        -   **6:**

            Use the first six blocks (96 bits) of the editors IPv6 address (for example "2001:0db8:85a3:08d3:1319:8a2e") as part of the session locking of Backend Users

        -   **7:**

            Use the first seven blocks (112 bits) of the editors IPv6 address (for example "2001:0db8:85a3:08d3:1319:8a2e:0370") as part of the session locking of Backend Users

        -   **8:**

            Use the editors full IPv6 address (for example "2001:0db8:85a3:08d3:1319:8a2e:0370:7344") as part of the session locking of Backend Users (highest security)

    Session IPv6 locking for backend users. See [\[FE\]\[lockIPv6\]](https://docs.typo3.org/permalink/t3coreapi:typo3confvars-fe-lockipv6@11.5) for details.

## sessionTimeout {#typo3confvars-be-sessiontimeout}

-   **$GLOBALS\['TYPO3_CONF_VARS'\]\['BE'\]\['sessionTimeout'\]**

    -   *type:* int
    -   *Default:* 28800

    Session time out for backend users in seconds. The value must be at least 180 to avoid side effects. Default is 28.800 seconds = 8 hours.

## IPmaskList {#typo3confvars-be-ipmasklist}

-   **$GLOBALS\['TYPO3_CONF_VARS'\]\['BE'\]\['IPmaskList'\]**

    -   *type:* list
    -   *Default:* ''

    Lets you define a list of IP-numbers (with \*-wildcards) that are the
    ONLY ones allowed access to ANY backend activity. On error an error header
    is sent and the script exits. Works like IP masking for users
    configurable through TSconfig.

    See syntax for that (or look up syntax for the function
    `\TYPO3\CMS\Core\Utility\GeneralUtility::cmpIP())`

    Have also a look into the [security guidelines](https://docs.typo3.org/permalink/t3coreapi:security-global-typo3-options-ipmasklist@11.5).

## lockSSL {#typo3confvars-be-lockssl}

-   **$GLOBALS\['TYPO3_CONF_VARS'\]\['BE'\]\['lockSSL'\]**

    -   *type:* bool
    -   *Default:* false

    If set, the backend can only be operated from an SSL-encrypted
    connection (https). A redirect to the SSL version of a URL will happen
    when a user tries to access non-https admin-urls

    Have also a look into the [security guidelines](https://docs.typo3.org/permalink/t3coreapi:security-global-typo3-options-lockssl@11.5).

## lockSSLPort {#typo3confvars-be-locksslport}

-   **$GLOBALS\['TYPO3_CONF_VARS'\]\['BE'\]\['lockSSLPort'\]**

    -   *type:* int
    -   *Default:*

    Use a non-standard HTTPS port for lockSSL. Set this value if you use
    lockSSL and the HTTPS port of your webserver is not 443.

## cookieDomain {#typo3confvars-be-cookiedomain}

-   **$GLOBALS\['TYPO3_CONF_VARS'\]\['BE'\]\['cookieDomain'\]**

    -   *type:* text
    -   *Default:* ''

    Same as `$TYPO3_CONF_VARS[SYS][cookieDomain]<typo3ConfVars_sys_cookieDomain>`
    but only for BE cookies. If empty, `$TYPO3_CONF_VARS[SYS][cookieDomain]`
    value will be used.

## cookieName {#typo3confvars-be-cookiename}

-   **$GLOBALS\['TYPO3_CONF_VARS'\]\['BE'\]\['cookieName'\]**

    -   *type:* text
    -   *Default:* 'be_typo_user'

    Set the name for the cookie used for the back-end user session

## cookieSameSite {#typo3confvars-be-cookiesamesite}

-   **$GLOBALS\['TYPO3_CONF_VARS'\]\['BE'\]\['cookieSameSite'\]**

    -   *type:* text
    -   *Default:* 'strict'
    -   *allowedValues:*

        -   **lax:**

            Cookies set by TYPO3 are only available for the current site,
            third-party integrations are not allowed to read cookies, except for
            links and simple HTML forms

        -   **strict:**

            Cookies sent by TYPO3 are only available for the current site, never
            shared to other third-party packages

        -   **none:**

            Allow cookies set by TYPO3 to be sent to other sites as well,
            please note - this only works with HTTPS connections

    Indicates that the cookie should send proper information where the cookie
    can be shared (first-party cookies vs. third-party cookies) in TYPO3 Backend.

## Removed: loginSecurityLevel {#typo3confvars-be-loginsecuritylevel}

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

This option was removed with version 11.3. The only possible
value has been 'normal'. This behaviour stays unchanged.  When this option
has been set in your LocalConfiguration.php
or AdditionalConfiguration.php files, they are automatically
removed when accessing the admin tool or system maintenance area.

## showRefreshLoginPopup {#typo3confvars-be-showrefreshloginpopup}

-   **$GLOBALS\['TYPO3_CONF_VARS'\]\['BE'\]\['showRefreshLoginPopup'\]**

    -   *type:* bool
    -   *Default:* false

    If set, the Ajax relogin will show a real popup window for relogin after
    the count down. Some auth services need this as they add custom validation
    to the login form. If its not set, the Ajax relogin will show an inline
    relogin window.

## adminOnly {#typo3confvars-be-adminonly}

-   **$GLOBALS\['TYPO3_CONF_VARS'\]\['BE'\]\['adminOnly'\]**

    -   *type:* int
    -   *Default:*
    -   *allowedValues:*

        -1: Total shutdown for maintenance purposes
        0: Default: All users can access the TYPO3 Backend
        1: Only administrators / system maintainers can log in, CLI interface is disabled as well
        2: Only administrators / system maintainers have access to the TYPO3 Backend, CLI executions are allowed as well

    Restricts access to the TYPO3 Backend - especially useful when doing maintenance or updates

## disable_exec_function {#typo3confvars-be-disable-exec-function}

-   **$GLOBALS\['TYPO3_CONF_VARS'\]\['BE'\]\['disable_exec_function'\]**

    -   *type:* bool
    -   *Default:* false

    Dont use exec() function (except for ImageMagick which is disabled by
    `[GFX][im]<typo3ConfVars_gfx_im>` =0). If set, all file operations are done
    by the default PHP-functions. This is necessary under Windows! On Unix the
    system commands by exec() can be used, unless this is disabled.

## compressionLevel {#typo3confvars-be-compressionlevel}

-   **$GLOBALS\['TYPO3_CONF_VARS'\]\['BE'\]\['compressionLevel'\]**

    -   *type:* text
    -   *Default:*
    -   *Range:* 0-9

    Determines output compression of BE output. Makes output smaller but slows
    down the page generation depending on the compression level. Requires

    -   zlib in your PHP installation and
    -   special rewrite rules for .css.gzip and .js.gzip

    (please see `_.htacces`  for an example). Range 1-9, where 1 is least
    compression and 9 is greatest compression. true as value will set the
    compression based on the PHP default settings (usually 5). Suggested and
    most optimal value is 5.

## installToolPassword {#typo3confvars-be-installtoolpassword}

-   **$GLOBALS\['TYPO3_CONF_VARS'\]\['BE'\]\['installToolPassword'\]**

    -   *type:* string
    -   *Default:* ''

    The hash of the install tool password.

## checkStoredRecords {#typo3confvars-be-checkstoredrecords}

-   **$GLOBALS\['TYPO3_CONF_VARS'\]\['BE'\]\['checkStoredRecords'\]**

    -   *type:* bool
    -   *Default:* true

    If set, values of the record are validated after saving in DataHandler.
    Disable only if using a database in strict mode.

## checkStoredRecordsLoose {#typo3confvars-be-checkstoredrecordsloose}

-   **$GLOBALS\['TYPO3_CONF_VARS'\]\['BE'\]\['checkStoredRecordsLoose'\]**

    -   *type:* bool
    -   *Default:* true

    If set, make a loose comparison ( equals 0) when validating record
    values after saving in DataHandler.

## defaultUserTSconfig {#typo3confvars-be-defaultusertsconfig}

-   **$GLOBALS\['TYPO3_CONF_VARS'\]\['BE'\]\['defaultUserTSconfig'\]**

    -   *type:* text

    Contains the default user TSconfig.

    This variable should not be changed directly but by the following API function.
    This makes your code less likely to change in the future.

    **my_sitepackage/ext_localconf.php**

    ```php
    /**
     * Adding the default User TSconfig
     */
    \TYPO3\CMS\Core\Utility\ExtensionManagementUtility::addUserTSConfig('
       @import 'EXT:my_sitepackage/Configuration/TSconfig/User/default.tsconfig'
    ');
    ```

    Read more about
    [Setting default User TSconfig](https://docs.typo3.org/m/typo3/reference-tsconfig/11.5/en-us/UsingSetting/UserTSconfig.html#usersettingdefaultusertsconfig).

## defaultPageTSconfig {#typo3confvars-be-defaultpagetsconfig}

-   **$GLOBALS\['TYPO3_CONF_VARS'\]\['BE'\]\['defaultPageTSconfig'\]**

    -   *type:* text

    Contains the default page TSconfig.

    This variable should not be changed directly but by the following API function.
    This makes your code less likely to change in the future.

    **`EXT:my_sitepackage/ext_localconf.php`**

    ```php
    use TYPO3\CMS\Core\Utility\ExtensionManagementUtility;

    ExtensionManagementUtility::addPageTSConfig('
       @import 'EXT:my_sitepackage/Configuration/TSconfig/Page/default.tsconfig'
    ');
    ```

    Read more about
    [Setting the Page TSconfig globally](https://docs.typo3.org/m/typo3/reference-tsconfig/11.5/en-us/UsingSetting/PageTSconfig.html#pagesettingdefaultpagetsconfig).

## defaultPermissions {#typo3confvars-be-defaultpermissions}

-   **$GLOBALS\['TYPO3_CONF_VARS'\]\['BE'\]\['defaultPermissions'\]**

    -   *type:* array
    -   *Default:* \[\]

    This option defines the default page permissions (`show`, `edit`, `delete`,
    `new`, `editcontent`). The following order applies:

    -   `defaultPermissions` from `\TYPO3\CMS\Core\DataHandling\PagePermissionAssembler`
    -   `$GLOBALS['TYPO3_CONF_VARS']['BE']['defaultPermissions']` (the option described here)
    -   Page TSconfig via [TCEMAIN.permissions](https://docs.typo3.org/m/typo3/reference-tsconfig/11.5/en-us/PageTsconfig/TceMain.html#pagetcemain-permissions-user-group)

    Example (which reflects the default permissions):

    **typo3conf/AdditionalConfiguration.php**

    ```php
    $GLOBALS['TYPO3_CONF_VARS']['BE']['defaultPermissions'] = [
       'user' => 'show,edit,delete,new,editcontent',
       'group' => 'show,edit,new,editcontent',
       'everybody' => '',
    ];
    ```

    If you want to deviate from the default permissions, for example by changing the everybody key,
    you only need to modify the key you wish to change:

    **typo3conf/AdditionalConfiguration.php**

    ```php
    $GLOBALS['TYPO3_CONF_VARS']['BE']['defaultPermissions'] = [
       'everybody' => 'show',
    ];
    ```

## defaultUC {#typo3confvars-be-defaultuc}

-   **$GLOBALS\['TYPO3_CONF_VARS'\]\['BE'\]\['defaultUC'\]**

    -   *type:* array
    -   *Default:* \[\]

    Defines the default user settings. The following order applies:

    -   `uc_default` in `\TYPO3\CMS\Core\Authentication\BackendUserAuthentication`
    -   `$GLOBALS['TYPO3_CONF_VARS']['BE']['defaultUC']` (the option described here)
    -   User TSconfig via [setup](https://docs.typo3.org/m/typo3/reference-tsconfig/11.5/en-us/UserTsconfig/Setup.html#usersetup)

    Example (which reflects the default user settings):

    **typo3conf/AdditionalConfiguration.php**

    ```php
    $GLOBALS['TYPO3_CONF_VARS']['BE']['defaultUC'] = [
       'emailMeAtLogin' => 0,
       'titleLen' => 50,
       'edit_RTE' => '1',
       'edit_docModuleUpload' => '1',
    ];
    ```

    Visit the [setup](https://docs.typo3.org/m/typo3/reference-tsconfig/11.5/en-us/UserTsconfig/Setup.html#usersetup) chapter of the User TSconfig guide for
    a list of all available options.

## customPermOptions {#typo3confvars-be-custompermoptions}

-   **$GLOBALS\['TYPO3_CONF_VARS'\]\['BE'\]\['customPermOptions'\]**

    -   *type:* array
    -   *Default:* \[\]

    Array with sets of custom permission options. Syntax is:

    **typo3conf/AdditionalConfiguration.php**

    ```php
    'key' => array(
       'header' => 'header string, language split',
       'items' => array(
          'key' => array('label, language split','icon reference', 'Description text, language split')
       )
    )
    ```

    Keys cannot contain characters any of the following characters: `:|,`.

## fileDenyPattern {#typo3confvars-be-filedenypattern}

-   **$GLOBALS\['TYPO3_CONF_VARS'\]\['BE'\]\['fileDenyPattern'\]**

    -   *type:* text
    -   *Default:* ''

    A perl-compatible and JavaScript-compatible regular expression (without
    delimiters `/`) that - if it matches a filename - will deny the
    file upload/rename or whatever.

    For security reasons, files with multiple extensions have to be denied on
    an Apache environment with mod_alias, if the filename contains a valid php
    handler in an arbitrary position. Also, ".htaccess" files have to be denied.
    Matching is done case-insensitive.

    Default value is stored in class constant
    `\TYPO3\CMS\Core\Resource\Security\FileNameValidator::FILE_DENY_PATTERN_DEFAULT`.

    Have also a look into the [security guidelines](https://docs.typo3.org/permalink/t3coreapi:security-global-typo3-options-filedenypattern@11.5).

## interfaces {#typo3confvars-be-interfaces}

-   **interfaces**

    -   *Path:* $GLOBALS\['TYPO3_CONF_VARS'\]\['BE'\]
    -   *type:* text
    -   *Default:* backend

    This determines which interface options are available in the login prompt

    (All options: "backend,frontend")

## explicitADmode {#typo3confvars-be-explicitadmode}

-   **explicitADmode**

    -   *Path:* $GLOBALS\['TYPO3_CONF_VARS'\]\['BE'\]
    -   *type:* dropdown
    -   *Default:* 'explicitAllow'
    -   *allowedValues:*

        -   **explicitAllow:**

            Administrators have to explicitly grant access for all editors and
            groups

        -   **explicitDeny:**

            Editors have access to all content types by default, access has
            to explicitly restricted

    Sets the general allow/deny mode for Content Element Types (CTypes) when
    granting or restricting access for backend users

## flexformForceCDATA {#typo3confvars-be-flexformforcecdata}

-   **$GLOBALS\['TYPO3_CONF_VARS'\]\['BE'\]\[flexformForceCDATA'\]**

    -   *type:* bool
    -   *Default:*

    If set, will add CDATA to Flexform XML. Some versions of libxml have a bug
    that causes HTML entities to be stripped from any XML content and this
    setting will avoid the bug by adding CDATA.

## versionNumberInFilename {#typo3confvars-be-versionnumberinfilename}

-   **$GLOBALS\['TYPO3_CONF_VARS'\]\['BE'\]\['versionNumberInFilename'\]**

    -   *type:* bool
    -   *Default:* false

    -   **If enabled, included CSS and JS files loaded in the TYPO3 Backend will**

        have the timestamp embedded in the filename, ie. `filename.1269312081.js` .
        This will make browsers and proxies reload the files if they change
        (thus avoiding caching issues).

        **IMPORTANT:** This feature requires extra `.htaccess` rules to
        work (please refer to the
        `typo3/sysext/install/Resources/Private/FolderStructureTemplateFiles/root-htaccess`
        file shipped with TYPO3).

        If disabled the last modification date of the file will be appended as a query-string.

## debug {#typo3confvars-be-debug}

-   **$GLOBALS\['TYPO3_CONF_VARS'\]\['BE'\]\['debug'\]**

    -   *type:* bool
    -   *Default:* false

    If enabled, the login refresh is disabled and pageRenderer is set to debug
    mode. Furthermore the fieldname is appended to the label of fields. Use
    this to debug the backend only!

## toolbarItems {#typo3confvars-be-toolbaritems}

-   **toolbarItems**

    -   *type:* array
    -   *Default:* \[\]

    Registered toolbar items classes

> [!NOTE]
> This configuration variable will be removed with version 12.0. Extensions who want to
> support both LTS 11 and 12 can set this variable and depend on Services to load the
> toolbar in LTS 12.  Using this configuration variable is **not deprecated** in
> LTS 11.

## HTTP {#typo3confvars-be-http}

-   **$GLOBALS\['TYPO3_CONF_VARS'\]\['BE'\]\['HTTP'\]**

    -   *type:* array
    -   *Default:*

        ```php
        [
           'Response' => [
              'Headers' => ['clickJackingProtection' => 'X-Frame-Options: SAMEORIGIN']
           ]
        ]
        ```

    Set HTTP headers to be sent with each backend request. Other keys than
    `['Response']['Headers']` are ignored.

## passwordHashing {#typo3confvars-be-passwordhashing-classname}

### className {#classname}

-   **$GLOBALS\['TYPO3_CONF_VARS'\]\['BE'\]\['passwordHashing'\]\['className'\]**

    -   *type:* string
    -   *Default:* `\TYPO3\CMS\Core\Crypto\PasswordHashing\Argon2iPasswordHash::class`
    -   *allowedValues:*

        -   **`\TYPO3\CMS\Core\Crypto\PasswordHashing\Argon2iPasswordHash::class`**

            Good password hash mechanism. Used by default if available.

        -   **`\TYPO3\CMS\Core\Crypto\PasswordHashing\Argon2idPasswordHash::class`**

            Good password hash mechanism.

        -   **`\TYPO3\CMS\Core\Crypto\PasswordHashing\BcryptPasswordHash::class`**

            Good password hash mechanism.

        -   **`\TYPO3\CMS\Core\Crypto\PasswordHashing\Pbkdf2PasswordHash::class`**

            Fallback hash mechanism if argon and bcrypt are not available.

        -   **`\TYPO3\CMS\Core\Crypto\PasswordHashing\PhpassPasswordHash::class`**

            Fallback hash mechanism if none of the above are available.

### options {#typo3confvars-be-passwordhashing-options}

-   **$GLOBALS\['TYPO3_CONF_VARS'\]\['BE'\]\['passwordHashing'\]\['options'\]**

    -   *type:* array
    -   *Default:* \[\]

    Special settings for specific hashes.
    See [Available hash algorithms](https://docs.typo3.org/permalink/t3coreapi:password-hashing-available-algorithms@11.5) for the different options
    depending on the algorithm.
