---
title: "Configuration Options"
manual: "Workspaces"
version: "main"
permalink: "https://docs.typo3.org/permalink/typo3/cms-workspaces:configuration@main"
source: "Administration/Configuration/Index.rst"
rendered: "2026-10-03T08:20:41+00:00"
---

# Configuration Options {#configuration}

There are a number of User TSconfig and Page TSconfig properties related to workspaces.

> [!NOTE]
> Some of these options are actually handled by the "version" system extension,
> but apply to workspaces.

-   [Page TSconfig](https://docs.typo3.org/permalink/typo3/cms-workspaces:page-tsconfig@main)
-   [User TSconfig](https://docs.typo3.org/permalink/typo3/cms-workspaces:user-tsconfig@main)

## Page TSconfig {#pagetsconfig}

### workspaces {#pagetsconfig-workspaces}

#### splitPreviewModes {#pagetsconfig-workspaces-splitpreviewmodes}

-   **Data type**

    String

-   **Description**

    Comma-separated list of allowed values for preview modes. Possible
    values are "slider", "vbox" and "hbox".

    **Example**

    ```typoscript
    workspaces.splitPreviewModes = slider
    ```

    will restrict the preview mode to "slider".

-   **Default**

    slider, vbox, hbox

### options.workspaces {#pagetsconfig-options-workspaces}

#### previewPageId {#pagetsconfig-options-workspaces-previewpageid}

-   **Data type**

    Integer / fieldReference per table

-   **Description**

    Page uid used for previewing records on a workspace.

    **Examples**

    ```typoscript
    # Using page 123 for previewing workspaces records (in general)
    options.workspaces.previewPageId = 123

    # Using the pid field of each record for previewing (in general)
    options.workspaces.previewPageId = field:pid

    # Using page 123 for previewing workspaces records (for table tx_myext_table)
    options.workspaces.previewPageId.tx_myext_table = 123

    # Using the pid field of each record for previewing (for table tx_myext_table)
    options.workspaces.previewPageId.tx_myext_table = field:pid
    ```

    > [!NOTE]
    > When used in conjunction with the [backend's preview mechanism](https://docs.typo3.org/m/typo3/reference-typoscript/main/en-us/PageTsconfig/TceMain.html#pagetcemain-preview),
    > this setting takes precedence over the `previewPageId` defined in
    > `TCEMAIN.preview`.

### tx_version.workspaces {#pagetsconfig-txversion-workspaces}

#### stageNotificationEmail.subject {#pagetsconfig-txversion-workspaces-stagenotificationemail-subject}

(`tx_version.workspaces.stageNotificationEmail.subject`)

-   **Data type**

    String / Localized string reference (using `LLL:` syntax).

-   **Description**

    The default subject for the stage notification email.

    The following markers can be used for replacement:

    -   `###SITE_NAME###`
    -   `###SITE_URL###`
    -   `###WORKSPACE_TITLE###`
    -   `###WORKSPACE_UID###`
    -   `###ELEMENT_NAME###`
    -   `###NEXT_STAGE###`
    -   `###COMMENT###`
    -   `###USER_REALNAME###`
    -   `###USER_USERNAME###`
    -   `###RECORD_PATH###`
    -   `###RECORD_TITLE###`

-   **Default**

    LLL:EXT:version/Resources/Private/Language/emails.xml:subject

#### stageNotificationEmail.message {#pagetsconfig-txversion-workspaces-stagenotificationemail-message}

(`tx_version.workspaces.stageNotificationEmail.message`)

-   **Data type**

    String / Localized string reference (using `LLL:` syntax).

-   **Description**

    The default message for the stage notification email.
    The same markers are available as for the subject (see above).

-   **Default**

    LLL:EXT:version/Resources/Private/Language/emails.xml:message

## User TSconfig {#usertsconfig}

### options.workspaces {#usertsconfig-options-workspaces}

#### enableMassActions {#usertsconfig-options-workspaces-enablemassactions}

-   **Data type**

    Boolean

-   **Description**

    If set to "0", the mass actions menu will not be available to users.

-   **Default**

    1

#### previewLinkTTLHours {#usertsconfig-options-workspaces-previewlinkttlhours}

-   **Data type**

    Integer

-   **Description**

    Number of hours until expiry of preview links to workspaces.

-   **Default**

    48

#### allowed_languages {#usertsconfig-options-workspaces-considerreferences}

-   **Property**

    workspaces.allowed_languages.\[workspaceId\]

-   **Data type**

    *(list of sys_language ids)*

-   **Description**

    This is a list of sys_language uids which will be allowed in a
    workspace. This list - if set - will override the allowed languages
    list in the BE user group configuration.

    **Example**

    ```typoscript
    options.workspaces.allowed_languages.3 = 1,2
    ```

    In this example, the user will be restricted to languages with "uid" 1 or 2
    in the workspace with "uid" 3.