---
title: "TEXT"
manual: "TypoScript Explained"
version: "main"
permalink: "https://docs.typo3.org/permalink/t3tsref:cobj-text@main"
source: "ContentObjects/Text/Index.rst"
rendered: "2026-09-19T06:55:14+00:00"
---

# TEXT {#cobj-text}

A content object of the type "TEXT" can be used to output static text or HTML.

stdWrap properties are available under the property "value" and on the
very rootlevel of the object.

> [!NOTE]
> Gifbuilder also has a [TEXT object](https://docs.typo3.org/permalink/t3tsref:gifbuilder-text@main) \-
> do not mix that one up with the cObject described here; both are
> different objects.

-   [Properties](https://docs.typo3.org/permalink/t3tsref:properties@main)
-   [Examples](https://docs.typo3.org/permalink/t3tsref:examples@main)

## Properties {#cobj-text-properties}

### value {#cobj-text-value}

-   **value**

    -   *Type:* [string](https://docs.typo3.org/permalink/t3tsref:data-type-string@main) / [stdWrap](https://docs.typo3.org/permalink/t3tsref:stdwrap@main)

    Text, which you want to output.

### stdWrap {#cobj-text-stdwrap}

-   **stdWrap**

    -   *Type:* [stdWrap](https://docs.typo3.org/permalink/t3tsref:stdwrap@main)

    stdWrap properties are available on the very root level of the
    object. This is non-standard! You should use these stdWrap
    properties consistently to those of the other cObjects by
    accessing them through the property "stdWrap".

### cache {#cobj-text-cache}

-   **cache**

    -   *Type:* [cache](https://docs.typo3.org/permalink/t3tsref:cache@main)

    See [cache function description](https://docs.typo3.org/permalink/t3tsref:cache@main) for details.

## Examples {#cobj-text-examples}

**EXT:site_package/Configuration/Sets/Main/setup.typoscript**

```typoscript
10 = TEXT
10.value = This is a text in uppercase
10.stdWrap.case = upper
```

The above example uses the stdWrap property [case](https://docs.typo3.org/permalink/t3tsref:stdwrap-case@main). It
returns "THIS IS A TEXT IN UPPERCASE".

**EXT:site_package/Configuration/Sets/Main/setup.typoscript**

```typoscript
10 = TEXT
10.value.field = title
10.stdWrap.wrap = <strong>|</strong>
```

The above example gets the header of the current page (which is
stored in the database field `title`). The header is then wrapped in
`<strong>` tags, before it is returned.

Now let us have a look at an extract from a more complex example:

**EXT:site_package/Configuration/Sets/Main/setup.typoscript**

```typoscript
10 = TEXT
10.value.field = bodytext
10.stdWrap.parseFunc < lib.parseFunc_RTE
10.stdWrap.dataWrap = <div>|</div>

```

The above example returns the content, which was found in the field
`bodytext` of the current record from $cObj->data-array. Here that
shall be the current record from the database table `tt_content`. This
is useful inside [COA](https://docs.typo3.org/permalink/t3tsref:cobj-coa@main) objects.

Here is the same example in its context:

**EXT:site_package/Configuration/Sets/Main/setup.typoscript**

```typoscript
10 = CONTENT
10 {
  table = tt_content
  select {
    where.dataWrap = irre_parentid  = {field:uid}
    begin = 0
  }

  renderObj = COA
  renderObj {
    stdWrap.if.isTrue.data = field:bodytext
    10 = TEXT
    10.value.field = bodytext
    10.stdWrap.parseFunc < lib.parseFunc_RTE
    10.stdWrap.dataWrap = <div>|</div>
  }
}

```

Here we use the cObject [CONTENT](https://docs.typo3.org/permalink/t3tsref:cobj-content@main) to return all content elements
(records from the database table "tt_content"), which are on the
current page. (These content elements have the corresponding value in
`irre_parentid`.) They are rendered using a [COA](https://docs.typo3.org/permalink/t3tsref:cobj-coa@main) cObject, which only
processes them, if there is content in the field `bodytext`.

The resulting records are each rendered using a TEXT object:

The TEXT object returns the content of the field `bodytext` of the
according `tt_content` record. (Note that the property "field" in this
context gets content from the table `tt_content` and not - as in
the example above - from `pages`. See the description for the
data type [getText/field](https://docs.typo3.org/permalink/t3tsref:data-type-gettext-field@main)!) The resulting content
is then parsed with [parseFunc](https://docs.typo3.org/permalink/t3tsref:parsefunc@main) and finally wrapped in `<div>` tags
before it is returned.
