--- title: "options" manual: "TypoScript Explained" version: "13.4" permalink: "https://docs.typo3.org/permalink/t3tsref:useroptions@13.4" source: "UserTsconfig/Options.rst" rendered: "2026-09-19T07:15:48+00:00" --- # options {#useroptions} Various options for the user affecting the Core at various points. As an example, this enables the **Flush frontend caches** button in the upper right toolbar cache menu for non-admin users: **EXT:site_package/Configuration/user.tsconfig** ```typoscript options.clearCache.pages = 1 ``` ## Properties {#useroptions-properties} **additionalPreviewLanguages** - **additionalPreviewLanguages** - *Type:* list of sys_language IDs The user will see these additional languages when localizing stuff in TCEforms. The list are IDs of site languages, as defined in the `languageId` property of the [site configuration](https://docs.typo3.org/m/typo3/reference-coreapi/13.4/en-us/ApiOverview/SiteHandling/AddLanguages.html#sitehandling-addingLanguages). **alertPopups** - **alertPopups** - *Type:* bitmask - *Default:* 255 (show all warnings) Configure which Javascript popup alerts have to be displayed and which not: - 1 – onTypeChange - 2 – copy / move / paste - 4 – delete - 8 – FE editing - 128 – other (not used yet) **bookmarkGroups** - **bookmarkGroups** - *Type:* Array of integers / strings Set groups of bookmarks that can be accessed by the user. This affects the bookmarks toolbar item in the top right of the backend. By default, 5 default groups will be defined globally (shared, can only be set by admins) and also for each user (personal bookmarks): 1. Pages 1. Records 1. Files 1. Tools 1. Miscellaneous Set 0 to disable one of these group IDs, 1 to enable it (this is the default) or "string" to change the label accordingly. Example: **EXT:site_package/Configuration/user.tsconfig** ```typoscript bookmarkGroups { 1 = 1 2 = My Group 3 = 0 4 = } ``` Bookmark group 1 is loaded with the default label (Pages), group 2 is loaded and labeled as "My Group" and groups 3 and 4 are disabled. Group 5 has not been set, so it will be displayed by default, just like group 1. Custom language labels can also be used instead of a fixed label: **EXT:site_package/Configuration/user.tsconfig** ```typoscript bookmarkGroups { 2 = LLL:EXT:sitepackage/Resources/Private/Language/locallang_be.xlf:bookmarkGroups.2 } ``` **clearCache** - **clearCache** **all** - **all** - *Type:* boolean - *Default:* 0 - *Path:* options.clearCache.all This will allow a non-admin user to clear frontend and page-related caches, plus some backend-related caches (that is everything including templates); if it is explicitly set to 0 for an admin user, it will remove the clear all option on toolbar for that user. **pages** - **pages** - *Type:* boolean - *Default:* 0 - *Path:* options.clearCache.pages If set to 1, this will allow a non-admin user to clear frontend and page-related caches. **clipboardNumberPads** - **clipboardNumberPads** - *Type:* integer (0-20) - *Default:* 3 This allows you to enter how many pads you want on the clipboard. **contextMenu.table.\[tableName\]\[.context\].disableItems** - **contextMenu.table.\[tableName\]\[.context\].disableItems** - *Type:* list of items List of [context menu](https://docs.typo3.org/m/typo3/reference-coreapi/13.4/en-us/ApiOverview/Backend/ContextualMenu.html#context-menu) ("clickmenu") items to disable. ![Context menu of the page tree](../Images/ManualScreenshots/List/PagesContextMenu.png) The `[tableName]` refers to the type of the record (database table name) the context menu is shown for, for example, `pages`, `sys_file`, `tt_content`, etc. The optional key `[.context]` refers to the place from which the context menu is triggered. The Core uses just one context called `tree` for context menus triggered from page tree and folder tree. This way you can disable certain options for one context, but keep them for another. Items to disable for "page" type are: - `view` - `edit` - `new` - `info` - `copy` - `copyRelease` - `cut` - `cutRelease` - `pasteAfter` - `pasteInto` - `newWizard` - `pagesSort` - `pagesNewMultiple` - `openListModule` - `mountAsTreeRoot` - `hideInMenus` - `showInMenus` - `permissions` - `enable` - `disable` - `delete` - `history` - `clearCache` Items to disable for "sys_file" type (that is files/folders) are: - `edit` - `rename` - `upload` - `new` - `info` - `copy` - `copyRelease` - `cut` - `cutRelease` - `pasteInto` - `delete` When the system extension Import/Export (EXT:impexp) is installed then two more options become available: - `exportT3d` - `importT3d` Example: **EXT:site_package/Configuration/user.tsconfig** ```typoscript # Remove "New" and "Create New wizard" for pages context menu (list module) options.contextMenu.table.pages.disableItems = new,newWizard # Remove "New" and "Create New wizard" in page tree context menu options.contextMenu.table.pages.tree.disableItems = new,newWizard # Remove the "More options" item in the page tree context menu and all its subelements options.contextMenu.table.pages.tree.disableItems = newWizard, pagesSort, pagesNewMultiple, openListModule, mountAsTreeRoot, exportT3d, importT3d, hideInMenus, showInMenus, permissions ``` **dashboard** - **dashboard** **dashboardPresetsForNewUsers** - **dashboardPresetsForNewUsers** - *Type:* list of dashboard identifiers - *Default:* default - *Path:* options.dashboard.dashboardPresetsForNewUsers List of dashboard identifiers to be used on initial dashboard module access. Example: **EXT:site_package/Configuration/user.tsconfig** ```typoscript options.dashboard.dashboardPresetsForNewUsers := addToList(customDashboard) ``` **defaultResourcesViewMode** - **defaultResourcesViewMode** - *Type:* `list` or `tiles` - *Default:* `tiles` The option `options.defaultResourcesViewMode` has been introduced, which allows to define the initial display mode. Valid values are therefore `list` and `tiles`, e.g.: The listing of resources in the TYPO3 Backend, e.g. in the **File > Filelist** module or the `FileBrowser` can be changed between `list` and `tiles`. TYPO3 serves by default `tiles`, if the user has not already made a choice. **EXT:site_package/Configuration/user.tsconfig** ```typoscript options.defaultResourcesViewMode = list ``` **defaultUploadFolder** - **defaultUploadFolder** - *Type:* string When a user uploads files they are stored in the default upload folder of the first file storage that user may access. The folder is used for uploads in the TCEforms fields. In general, this will be `fileadmin/user_upload/`. With this property it is possible to set a specific upload folder. The syntax is "storage_uid:file_path". > [!NOTE] > It is also possible to set a default upload folder for a page via > [page TSconfig](https://docs.typo3.org/permalink/t3tsref:pagedefaultuploadfolder@13.4). Example: **EXT:site_package/Configuration/user.tsconfig** ```typoscript options.defaultUploadFolder = 2:user_folders/my_folder/ ``` **disableDelete** - **disableDelete** - *Type:* boolean Disables the **Delete** button in TCEFORMs. Note, it is possible to set this for single tables using `options.disableDelete.`. Any value set for a single table will override the default value set for `disableDelete`. Example: **EXT:site_package/Configuration/user.tsconfig** ```typoscript options.disableDelete.tt_content = 1 ``` **dontMountAdminMounts** - **dontMountAdminMounts** - *Type:* boolean This options prevents the root to be mounted for an admin user. > [!NOTE] > Only for admin users. For other users it has no effect. **enableBookmarks** - **enableBookmarks** - *Type:* boolean - *Default:* 1 Enables the usage of bookmarks in the backend. **file_list** - **file_list** **enableClipBoard** - **enableClipBoard** - *Type:* list of keywords - *Default:* selectable - *Path:* options.file_list.enableClipBoard Determines whether the checkbox **Show clipboard** in the file list module is shown or hidden. If it is hidden, you can predefine it to be always activated or always deactivated. The following values are possible: - **`activated`** The option is activated and the checkbox is hidden. - **`deactivated`** The option is deactivated and the checkbox is hidden. - **`selectable`** The checkbox is shown so that the option can be selected by the user. **displayColumnSelector** - **displayColumnSelector** - *Type:* boolean - *Default:* true - *Path:* options.file_list.displayColumnSelector The column selector is enabled by default and can be disabled with this option. The column selector is displayed at the top of each file list. It can be used to manage the fields displayed for each file / folder, while containing convenience actions such as "filter", "check all / none" and "toggle selection". The fields to be selected are a combination of special fields, such as `references` or `read/write` permissions, the corresponding `sys_file` record fields, as well as all available `sys_file_metadata` fields. Example: **EXT:site_package/Configuration/user.tsconfig** ```typoscript # Disable the column selector file_list.displayColumnSelector = 0 ``` **file_list.enableDisplayThumbnails** - **file_list.enableDisplayThumbnails** - *Type:* list of keywords - *Default:* selectable Determines whether the checkbox **Display thumbnails** in the file list module is shown or hidden. If it is hidden, you can predefine it to be always activated or always deactivated. The following values are possible: - **`activated`** The option is activated and the checkbox is hidden. - **`deactivated`** The option is deactivated and the checkbox is hidden. - **`selectable`** The checkbox is shown so that the option can be selected by the user. **filesPerPage** - **filesPerPage** - *Type:* integer - *Default:* 40 - *Path:* options.file_list.filesPerPage The maximum number of files shown per page in the **File > List** module. **primaryActions** - **primaryActions** - *Type:* string - *Default:* `view,metadata,translations,delete` - *Path:* options.file_list.primaryActions Option to add more primary actions to the list view, which are otherwise only accessible through the "..." menu in the file list module. The list of actions to be displayed can be given in the TSConfig of the backend user. The actions that can be set are - `copy` - `cut` - `delete` - `download` - `edit` - `info` - `metadata` - `paste` - `rename` - `replace` - `translations` (always active) - `updateOnlineMedia` - `upload` - `view` Example: **EXT:site_package/Configuration/user.tsconfig** ```typoscript # This will add "copy", "cut" and "replace" buttons in addition to the three default # buttons. "translations" can be omitted, as it will be added by default, # if a TYPO3 site is set up multilingual. options.file_list.primaryActions = view,metadata,delete,copy,cut,replace ``` ![Show primary action with additional copy, cut and replace buttons](../Images/ManualScreenshots/List/FileListPrimaryActions.png) **thumbnail.height** - **thumbnail.height** - *Type:* integer - *Default:* 64 - *Path:* options.file_list.thumbnail.height All preview images in the file list will be rendered with the configured thumbnail height. **thumbnail.width** - **thumbnail.width** - *Type:* integer - *Default:* 64 - *Path:* options.file_list.thumbnail.width All preview images in the file list will be rendered with the configured thumbnail width. **uploader.defaultAction** - **uploader.defaultAction** - *Type:* string - *Default:* `Cancel` - *Path:* options.file_list.uploader.defaultAction Default action for the modal that appears when during file upload a name collision occurs. Possible values: - **`cancel`** Abort the action. - **`rename`** Append the file name with a numerical index. - **`replace`** Override the file with the uploaded one. **folderTree** - **folderTree** **altElementBrowserMountPoints** - **altElementBrowserMountPoints** - *Type:* list of "storageUid:folderName" items - *Path:* options.folderTree.altElementBrowserMountPoints Sets alternative filemounts for use in any folder tree, including in the **File > List** module, in the element browser and in file selectors. Each item consists of storage UID followed by a colon and the folder name inside that storage. Separate multiple items by a comma. For backwards compatibility, defining only a folder name but no storage uid and colon prepended is still supported. Folders without a storage UID prepended are assumed to be located in the default storage, which by default is the `fileadmin/` folder. If a folder you specify does not exist it will not get mounted. Settings this option is effective in [workspaces](https://docs.typo3.org/m/typo3/reference-coreapi/13.4/en-us/ApiOverview/Workspaces/Index.html#workspaces) too. The alternative file mounts are added to the existing ones defined in the user or group configuration. Example: **EXT:site_package/Configuration/user.tsconfig** ```typoscript options.folderTree.altElementBrowserMountPoints = _temp_/, 2:/templates, 1:/files/images ``` **uploadFieldsInLinkBrowser** - **uploadFieldsInLinkBrowser** - *Type:* integer - *Default:* 3 - *Path:* options.folderTree.uploadFieldsInLinkBrowser This value defines the number of upload fields in the element browser. Default value is 3, if set to 0, no upload form will be shown. **hideModules** - **hideModules** - *Type:* list of module groups or modules Configure which module groups or modules should be hidden from the main menu. > [!WARNING] > **Attention** > > It is not an access restriction but makes defined modules invisible. > This means that in principle these modules can still be accessed if the > rights allow this. > [!TIP] > **Hint** > > A list of all available module groups and modules can be found in in the > backend module **System > Configuration > Backend Modules**. The > system extension "lowlevel" has to be available for accessing this list. Example: **EXT:site_package/Configuration/user.tsconfig** ```typoscript # Hide only module groups "file" and "help" options.hideModules = file, help # Hide additional modules "info" and "ts" from the "web" group options.hideModules := addToList(web_info, web_ts) # Hide only module BeLogLog from "system" group options.hideModules = system_BelogLog ``` **hideRecords** - **hideRecords** **pages** - **pages** - *Type:* list of page IDs - *Path:* options.hideRecords.pages This setting hides records in the backend user interface. It is not an access restriction but makes defined records invisible. That means in principle those records can still be edited if the user rights allow. This makes sense if only a specialized module should be used to edit those otherwise hidden records. This option is currently implemented for the pages table only and has an effect in the following places: - Page tree navigation frame - **Web > List** module - New record wizard Example: **EXT:site_package/Configuration/user.tsconfig** ```typoscript options.hideRecords.pages = 12,45 ``` **impexp** - **impexp** **enableExportForNonAdminUser** - **enableExportForNonAdminUser** - *Type:* boolean - *Default:* 0 - *Path:* options.impexp.enableExportForNonAdminUser > [!NOTE] > This option was introduced to avoid [information disclosure](https://typo3.org/security/advisory/typo3-core-sa-2022-001). The import/export module of `EXT:impexp` is disabled by default for non-admin users. Enable this option, if non-admin users need to use the module and export data. This should only be enabled for trustworthy backend users, as it might impose a security risk. - **enableImportForNonAdminUser** - *Type:* boolean - *Default:* 0 - *Path:* options.impexp.enableImportForNonAdminUser > [!NOTE] > This option was introduced to avoid [information disclosure](https://typo3.org/security/advisory/typo3-core-sa-2016-015). The import/export module of `EXT:impexp` is disabled by default for non-admin users. Enable this option, if non-admin users need to use the module and import data. This should only be enabled for trustworthy backend users, as it might impose a security risk. **mayNotCreateEditBookmarks** - **mayNotCreateEditBookmarks** - *Type:* boolean If set, the user can not create or edit bookmarks. **noThumbsInEB** - **noThumbsInEB** - *Type:* boolean If set, then image thumbnails are not shown in the element browser. **pageTree** - **pageTree** - **overridePageModule** This setting has been removed.In order to replace the **Web > Page** module within a third-party extension, such as TemplaVoila, it is possible to create a custom module entry in an extension's `Configuration/Backend/Modules.php` with the following entry: **EXT:my_extension/Configuration/Backend/Modules.php** ```php return [ 'my_module' => [ 'parent' => 'web', 'position' => ['before' => '*'], 'access' => 'user', 'aliases' => ['web_layout'], 'path' => '/module/my_module', 'iconIdentifier' => 'module-page', 'labels' => 'LLL:EXT:backend/Resources/Private/Language/locallang_mod.xlf', 'routes' => [ '_default' => [ 'target' => \MyVendor\MyExtension\Controller\MyController::class . '::mainAction', ], ], ], ]; ``` **altElementBrowserMountPoints** - **altElementBrowserMountPoints** - *Type:* list of integers - *Path:* options.pageTree.altElementBrowserMountPoints Sets alternative webmounts for use in the element browser. You separate page IDs by a comma. Non-existing page IDs are ignored. If you insert a non-integer it will evaluate to "0" (zero) and the root of the page tree is mounted. Effective in [workspaces](https://docs.typo3.org/m/typo3/reference-coreapi/13.4/en-us/ApiOverview/Workspaces/Index.html#workspaces) too. These alternative webmounts **replace** configured DB mount points unless you use the [altElementBrowserMountPoints.append](https://docs.typo3.org/permalink/t3tsref:useroptions-pagetree-altelementbrowsermountpoints-append@13.4) option. Example: **EXT:site_package/Configuration/user.tsconfig** ```typoscript options.pageTree.altElementBrowserMountPoints = 34,123 ``` **altElementBrowserMountPoints.append** - **altElementBrowserMountPoints.append** - *Type:* boolean - *Path:* options.pageTree.altElementBrowserMountPoints.append This option allows administrators to add additional mount points in the RTE and the wizard element browser instead of replacing the configured database mount points of the user when using the existing user TSconfig option. Example: **EXT:site_package/Configuration/user.tsconfig** ```typoscript options.pageTree.altElementBrowserMountPoints = 34,123 options.pageTree.altElementBrowserMountPoints.append = 1 ``` - **backgroundColor** - *Type:* string - *Path:* options.pageTree.backgroundColor This setting has been deprecated and will be removed in TYPO3 v14 due to its lack of accessibility. It is being replaced with a new label system for tree nodes.In TYPO3 v13 the setting will be migrated to the new label system. Since the use case is unknown, the generated label will be "Color: \". This information will be displayed on all affected nodes. Set background colors for tree branches. The color can be any valid CSS color value. The best results can be achieved by using RGBa values. Example: **EXT:site_package/Configuration/user.tsconfig** ```typoscript # The syntax is: # options.pageTree.backgroundColor. = options.pageTree.backgroundColor.147 = orange options.pageTree.backgroundColor.148 = #AFAFAF options.pageTree.backgroundColor.151 = rgba(0, 255, 0, 0.1) ``` ![Tree branches with configured background colors](../Images/ManualScreenshots/List/optionsPageTreeBackgroundColor.png) **doktypesToShowInNewPageDragArea** - **doktypesToShowInNewPageDragArea** - *Type:* string - *Default:* 1,6,4,7,3,254,255,199 - *Path:* options.pageTree.doktypesToShowInNewPageDragArea If set, the node top panel feature can be configured by a comma-separated list. Each number stands for a [doktype ID](https://docs.typo3.org/m/typo3/reference-coreapi/13.4/en-us/ApiOverview/PageTypes/TypesOfPages.html#list-of-page-types) that should be added to the node top panel. ![Top panel in normal mode](../Images/ManualScreenshots/List/PanelNormal.png) ![Top panel modified](../Images/ManualScreenshots/List/PanelModified.png) **excludeDoktypes** - **excludeDoktypes** - *Type:* list of integers - *Path:* options.pageTree.excludeDoktypes Excludes nodes (pages) with one of the defined [doktypes](https://docs.typo3.org/m/typo3/reference-coreapi/13.4/en-us/ApiOverview/PageTypes/TypesOfPages.html#list-of-page-types) from the page tree. Can be used, for example, for hiding [custom doktypes](https://docs.typo3.org/m/typo3/reference-coreapi/13.4/en-us/ApiOverview/PageTypes/CreateNewPageType.html#page-types-example). Example: **EXT:site_package/Configuration/user.tsconfig** ```typoscript options.pageTree.excludeDoktypes = 254,1 ``` **label.\** - **label.\** - *Type:* list of page IDs - *Path:* options.pageTree.label.\ This setting is the successor of .Labels offer customizable color markings for tree nodes and require an associated label for accessibility. Example: **EXT:my_extension/Configuration/user.tsconfig** ```typoscript options.pageTree.label.296 { label = Campaign A color = #ff8700 } ``` Display: ![Page with configured color and label](../Images/ManualScreenshots/List/optionsPageTreeLabel.png) > [!NOTE] > Only one label per page can be set through this method. Use the > PSR-14 event [AfterPageTreeItemsPreparedEvent](https://docs.typo3.org/m/typo3/reference-coreapi/13.4/en-us/ApiOverview/Events/Events/Backend/AfterPageTreeItemsPreparedEvent.html#AfterPageTreeItemsPreparedEvent) to assign > multiple labels to a page. **showDomainNameWithTitle** - **showDomainNameWithTitle** - *Type:* boolean - *Path:* options.pageTree.showDomainNameWithTitle If set, the domain name will be appended to the page title for pages that have **Is root of web site?** checked in the page properties. Useful if there are several domains in one page tree. **showNavTitle** - **showNavTitle** - *Type:* boolean - *Path:* options.pageTree.showNavTitle If set, the navigation title is displayed in the page navigation tree instead of the normal page title. The page title is shown in a tooltip if the mouse hovers the navigation title. **showPageIdWithTitle** - **showPageIdWithTitle** - *Type:* boolean - *Path:* options.pageTree.showPageIdWithTitle If set, the titles in the page tree will have their ID numbers printed before the title. **showPathAboveMounts** - **showPathAboveMounts** - *Type:* boolean - *Path:* options.pageTree.showPathAboveMounts If set, the user db mount path above the mount itself is shown. This is useful if you work a lot with user db mounts. ![Active user db mount](../Images/ManualScreenshots/List/PanelUserDB.png) **passwordReset** - **passwordReset** - *Type:* boolean - *Default:* 1 If set to `0` the initiating of the password reset in the backend will be disabled. This does not affect the password reset by CLI command. To completely disable the password reset in the backend for all users, you can set the user TSconfig globally in your `Configuration/user.tsconfig`: **EXT:site_package/Configuration/user.tsconfig** ```typoscript options.passwordReset = 0 ``` If required, this setting can be overridden on a per user basis in the corresponding **TSconfig** field of the backend usergroup or user. The password reset functionality can also be disabled globally by setting: **config/system/settings.php | typo3conf/system/settings.php** ```php $GLOBALS['TYPO3_CONF_VARS']['BE']['passwordReset'] = false ``` **saveClipboard** - **saveClipboard** - *Type:* boolean If set, the clipboard content will be preserved for the next login. Normally the clipboard content lasts only during the session. **saveDocNew** - **saveDocNew** - *Type:* boolean / "top" - *Default:* 1 If set, a button **Save and create new** will appear in TCEFORMs. Note, it is possible to set this for single tables using `options.saveDocNew.[tableName]`. Any value set for a single table will override the default value set for `saveDocNew`. Example: In this example the button is disabled for all tables, except `tt_content` where it will appear, and in addition create the records in the top of the page (default is after instead of top). **EXT:site_package/Configuration/user.tsconfig** ```typoscript options.saveDocNew = 0 options.saveDocNew.tt_content = top ``` **saveDocView** - **saveDocView** - *Type:* boolean - *Default:* 1 If set, a button **Save and view** will appear in TCEFORMs. Note, it is possible to set this for single tables using `options.saveDocView.[tableName]`. Any value set for a single table will override the default value set for `saveDocView`. **showDuplicate** - **showDuplicate** - *Type:* boolean - *Default:* 0 If set, a button **Duplicate** will appear in TCEFORMs. Note, that it is possible to set this for single tables using `options.showDuplicate.[tableName]`. Any value set for a single table will override the default value set for `showDuplicate`. **showHistory** - **showHistory** - *Type:* boolean Shows link to the history for the record in TCEFORMs. Note, it is possible to set this for single tables using `options.showHistory.[tableName]`. Any value set for a single table will override the default value set for `showHistory`. **hideSets** - **hideSets** - *Type:* comma separated list Hides existing [Site sets](https://docs.typo3.org/m/typo3/reference-coreapi/13.4/en-us/ApiOverview/SiteHandling/SiteSets.html#site-sets) from the list of available sets for backend users, in case only a curated list of sets shall be selectable: **EXT:my_extension/Configuration/user.tsconfig** ```typoscript options.sites.hideSets := addToList(typo3/fluid-styled-content) ``` The **Site Management > Sites** GUI will not show hidden sets, but makes one exception if a hidden set has already been applied to a site In this case a set marked as hidden will be shown in the list of currently activated sets (that means it can be introspected and removed via backend UI).