---
title: "2.4"
manual: "Content Blocks"
version: "main"
permalink: "https://docs.typo3.org/permalink/friendsoftypo3/content-blocks:changelog-2-4@main"
source: "ChangeLog/2.4/Index.rst"
rendered: "2026-09-22T14:15:39+00:00"
---

# 2.4 {#changelog-2-4}

Content Blocks version 2.4 adds a collection of small new features.

-   [Feature](https://docs.typo3.org/permalink/friendsoftypo3/content-blocks:feature@main)

## Feature {#feature}

### Identifier `alias` for fields {#identifier-alias-for-fields}

You can now define an `alias` for fields, which will then be used instead
of the `identifier` in your Fluid templates. This has two main advantages:

1.  You are not forced to use snake_case in Fluid, just because it is better
    suited for database column names.
1.  You can use semantic names when re-using shared, generic fields in the
    context of your Content Block.

```yaml
name: example/cta
fields:
  - identifier: header
    alias: title
```

### Field Type SelectText {#field-type-selecttext}

A new field type [SelectText](https://docs.typo3.org/permalink/friendsoftypo3/content-blocks:field-type-select-text@main) is added. This
new type allows to have a select field with exclusively text values. The
database column will also have type `varchar(255)`, instead of
`longtext`.

```yaml
name: example/select-text
fields:
  - identifier: select_text
    type: SelectText
    items:
      - label: 'The first'
        value: 'first'
      - label: 'The second'
        value: 'second'
```

### New option `hideInUi` for Record Types {#new-option-hideinui-for-record-types}

It is now possible to explicitly hide Record Types in the record overview
by defining `hideInUi: true`. This is already done automatically when
the Record Type is used as a child item in Collections.

### New automatic language keys {#new-automatic-language-keys}

New automatic language keys are added, which can now be used in the labels.xlf
file:

-   `placeholder` (for types with input field: Text, Textarea, Email, ...)
-   `labelChecked` (for [Checkbox](https://docs.typo3.org/permalink/friendsoftypo3/content-blocks:confval-checkbox-items@main) with `renderType: checkboxLabeledToggle`)
-   `labelUnchecked` (for [Checkbox](https://docs.typo3.org/permalink/friendsoftypo3/content-blocks:confval-checkbox-items@main) with `renderType: checkboxLabeledToggle`)

See [here](https://docs.typo3.org/permalink/friendsoftypo3/content-blocks:api-automatic-language-keys@main) for more information.

### Site and Site Settings available in backend previews {#site-and-site-settings-available-in-backend-previews}

You have now access to the `site` and `siteSettings` variables in
your backend-preview.html templates. Having these, you can now display your
previews depending on the current site and settings. This is especially useful
if you define special colors in your theme and want to load CSS variables into
your templates.

### Generate frontend and backend preview templates via CLI {#generate-frontend-and-backend-preview-templates-via-cli}

Two new commands allow you to generate starter Fluid templates for a Content
Block directly from the command line:

-   `content-blocks:generate:frontend` generates
    `templates/frontend.fluid.html`
-   `content-blocks:generate:backend-preview` generates
    `templates/backend-preview.fluid.html`

Both commands require the Content Block name as an argument and will not
overwrite an existing file unless the `--force` option is given.

```bash
vendor/bin/typo3 content-blocks:generate:frontend example/my-block
vendor/bin/typo3 content-blocks:generate:backend-preview example/my-block
```

See [Generate Frontend Template Command](https://docs.typo3.org/permalink/friendsoftypo3/content-blocks:command-generate-frontend-template@main) and
[Generate Backend Preview Template Command](https://docs.typo3.org/permalink/friendsoftypo3/content-blocks:command-generate-backend-preview-template@main) for details.