---
title: "TypoScript string formats"
manual: "TypoScript Explained"
version: "13.4"
permalink: "https://docs.typo3.org/permalink/t3tsref:string-formats@13.4"
source: "Syntax/StringFormats/Index.rst"
rendered: "2026-09-19T07:15:48+00:00"
---

# TypoScript string formats {#string-formats}

The values assigned to properties in TypoScript are internally handled as
strings.

Some properties expect a certain format of string. These formats are described
in this chapter.

Enforcing these string formats is up to the implementation of the property using
them. They are therefore no real constructs of the TypoScript syntax.

-   [boolean](https://docs.typo3.org/permalink/t3tsref:boolean@13.4)
-   [date-conf](https://docs.typo3.org/permalink/t3tsref:date-conf@13.4)
-   [function name](https://docs.typo3.org/permalink/t3tsref:function-name@13.4)
-   [integer](https://docs.typo3.org/permalink/t3tsref:integer@13.4)
-   [path](https://docs.typo3.org/permalink/t3tsref:path@13.4)
-   [resource](https://docs.typo3.org/permalink/t3tsref:resource@13.4)
-   [string](https://docs.typo3.org/permalink/t3tsref:string@13.4)

## boolean {#data-type-boolean}

-   **boolean**

    Possible values for boolean variables are `1` and `0`
    meaning TRUE and FALSE.

    Everything else is [evaluated to one of these values by PHP](https://www.php.net/manual/en/language.types.boolean.php):
    Non-empty strings (except `0` \[zero\]) are treated as TRUE,
    empty strings are evaluated to FALSE.

    **Examples**

    **EXT:site_package/Configuration/TypoScript/setup.typoscript**

    ```typoscript
    dummy.enable = 0   # false, preferred notation
    dummy.enable = 1   # true,  preferred notation
    dummy.enable =     # false, because the value is empty
    ```

## date-conf {#data-type-date-conf}

-   **date-conf**

    Used to format a date, see PHP function `date()`. See the
    documentation of [allowed date time formats in
    PHP](https://www.php.net/manual/en/datetime.format.php).

    **Example**

    **EXT:site_package/Configuration/TypoScript/setup.typoscript**

    ```typoscript
    page.10.date-conf = d-m-y
    ```

## function name {#data-type-function-name}

-   **function name**

    Indicates a function or method in a class to call. See more information at
    the [USER cObject](https://docs.typo3.org/permalink/t3tsref:cobj-user@13.4).

    **Examples**

    Method name in a namespaced class:

    ```typoscript
    lib.someThing = USER_INT
    lib.someThing.userFunc = MyVendor\MyExtension\SomeNamespace\SomeClass->someFunction
    ```

    **EXT:my_extension/Classes/SomeNamespace/SomeClass.php**

    ```php
    <?php

    namespace MyVendor\MyExtension\SomeNamespace;

    use Psr\Http\Message\ServerRequestInterface;

    class SomeClass
    {
      /**
       * @param string $content Empty string (no content to process)
       * @param array $conf TypoScript configuration
       */
      public function someFunction(string $content, array $conf, ServerRequestInterface $request): string
      {
        $changedContent = $content;
        // Do something
        return $changedContent;
      }
    }

    ```

## integer {#data-type-integer}

-   **integer**

    **Examples**

    42, -8, -9, 0

    Positive integers expect to be greater or equal zero.

## path {#data-type-path}

-   **path**

    Path relative to the root directory from which we operate.
    Also resolves `EXT:` syntax.

    **Example**

    **EXT:site_package/Configuration/TypoScript/setup.typoscript**

    ```typoscript
    page.10.settings.somePath = fileadmin/stuff/
    ```

## resource {#data-type-resource}

-   **resource**

    If the value contains a "/", it is expected to be a reference (absolute or
    relative) to a file in the file system. There is no support for wildcard
    characters in the name of the reference.

    **Example**

    Reference to a file in the file system:

    **EXT:site_package/Configuration/TypoScript/setup.typoscript**

    ```typoscript
    page.10.settings.someFile = fileadmin/picture.gif
    ```

## string {#data-type-string}

-   **string**

    Any property in TypoScript is a string technically. String can be defined
    in a single line or with multiple lines, using the
    [Multiline assignment with "(" and ")"](https://docs.typo3.org/permalink/t3tsref:typoscript-syntax-syntax-multiline-values@13.4).

    **Example**

    **EXT:site_package/Configuration/TypoScript/setup.typoscript**

    ```typoscript
    page.10.value = The quick brown fox jumps over the lazy dog.
    ```

    **Extension examples, file Configuration/TypoScript/Syntax/ObjectUnset/setup.typoscript**

    ```typoscript
    myIdentifier.mySubIdentifier = TEXT
    myIdentifier.mySubIdentifier = myValue
    myIdentifier.mySubIdentifier.stdWrap = <p>|</p>

    # "myIdentifier.mySubIdentifier" is completely removed, including value
    # assignment and sub identifier "stdWrap"
    myIdentifier.mySubIdentifier >

    # Same as above: Everything after ">" operator is considered a comment
    myIdentifier.mySubIdentifier > // Some comment

    ```