---
title: "Format.case ViewHelper <f:format.case>"
manual: "Fluid Explained"
version: "main"
permalink: "https://docs.typo3.org/permalink/fluid:typo3fluid-fluid-format-case"
source: "ViewHelpers/Fluid/Format/Case.rst"
rendered: "2026-09-26T08:24:58+00:00"
---

# Format.case ViewHelper `<f:format.case>` {#typo3fluid-fluid-format-case}

> [!NOTE]
> This reference is part of the documentation of Fluid Standalone.
> If you are working with Fluid in TYPO3 CMS, please refer to
> [TYPO3's ViewHelper reference](https://docs.typo3.org/other/typo3/view-helper-reference/14.3/en-us/Global/Format/Case.html) instead.

Modifies the case of an input string to upper- or lowercase or capitalization.
The default transformation will be uppercase as in [mb_convert_case](https://www.php.net/manual/function.mb-convert-case.php).

Possible modes are:

-   **`lower`**

    Transforms the input string to lowercase
    Example: "Hello World" -> "hello world"

-   **`upper`**

    Transforms the input string to uppercase
    Example: "Hello World" -> "HELLO WORLD"

-   **`capital`**

    Transforms the first character of the input string to uppercase
    Example: "hello world" -> "Hello world"

-   **`uncapital`**

    Transforms the input string to its first letter lower-cased
    Example: "Hello World" -> "hello World"

-   **`capitalWords`**

    Transforms the input string to capitalize each word
    Example: "hello world" -> "Hello World"

Note that the behavior will be the same as in the appropriate PHP function [mb_convert_case](https://www.php.net/manual/function.mb-convert-case.php);
especially regarding locale and multibyte behavior.

## Examples {#examples}

### Default {#default}

```php
<f:format.case>Some Text with miXed case</f:format.case>

```

Output:

```php
SOME TEXT WITH MIXED CASE

```

### Example with given mode {#example-with-given-mode}

```php
<f:format.case mode="capital">someString</f:format.case>

```

Output:

```php
SomeString
```

Go to the source code of this ViewHelper: [Format\\CaseViewHelper.php (GitHub)](https://github.com/TYPO3/Fluid/blob/main/src/ViewHelpers/Format/CaseViewHelper.php).

**Arguments**

The following arguments are available for the format.case ViewHelper:

-   **mode**

    -   *Type:* string
    -   *Default:* 'upper'

    The case to apply, must be one of this' CASE\_\* constants. Defaults to uppercase application.

-   **value**

    -   *Type:* string

    The input value. If not given, the evaluated child nodes will be used.