NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist, #3220 most downloaded on Packagist
TYPO3 CMS Content Blocks - Content Types API | Define reusable components via YAML
Latest stable
2.4.10
Last release 1 months ago
22 Sep 2026
Ships fairly regularly
a new release about every 2 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
3 years old
136 releases · first in 2023
Drag across the ruler to compare, or tap a release to open it.
[BUGFIX] Respect numeric key order in RootPathsSettings by @georg-tiefenbrunn in https://github.com/FriendsOfTYPO3/content-blocks/pull/412
Full Changelog: https://github.com/FriendsOfTYPO3/content-blocks/compare/1.3.9...1.3.10
[BUGFIX] Fix page-type-specific layoutRootPath by @georg-tiefenbrunn in https://github.com/FriendsOfTYPO3/content-blocks/pull/409
Full Changelog: https://github.com/FriendsOfTYPO3/content-blocks/compare/1.3.8...1.3.9
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Full Changelog: https://github.com/FriendsOfTYPO3/content-blocks/compare/1.3.7...1.3.8
Full Changelog: https://github.com/FriendsOfTYPO3/content-blocks/compare/1.3.7...1.3.8
[DOCS] correct data reference in cObject view helper by @SimonMayr in https://github.com/FriendsOfTYPO3/content-blocks/pull/401
Full Changelog: https://github.com/FriendsOfTYPO3/content-blocks/compare/1.3.6...1.3.7
[DOCS] Add guide: Create Extbase Plugins with Content Blocks by @SimonMayr in https://github.com/FriendsOfTYPO3/content-blocks/pull/394
Full Changelog: https://github.com/FriendsOfTYPO3/content-blocks/compare/1.3.5...1.3.6
Add new command functional test for extension:setup to reproduce cache issues from Version 1.3.2 by @steffenmaechtel in https://github.com/FriendsOfTY
Full Changelog: https://github.com/FriendsOfTYPO3/content-blocks/compare/1.3.4...1.3.5
Full Changelog: https://github.com/FriendsOfTYPO3/content-blocks/compare/1.3.3...1.3.4
Full Changelog: https://github.com/FriendsOfTYPO3/content-blocks/compare/1.3.3...1.3.4
Full Changelog: https://github.com/FriendsOfTYPO3/content-blocks/compare/1.3.2...1.3.3
Full Changelog: https://github.com/FriendsOfTYPO3/content-blocks/compare/1.3.2...1.3.3
Full Changelog: https://github.com/FriendsOfTYPO3/content-blocks/compare/1.3.1...1.3.2
Full Changelog: https://github.com/FriendsOfTYPO3/content-blocks/compare/1.3.1...1.3.2
Full Changelog: https://github.com/FriendsOfTYPO3/content-blocks/compare/1.3.0...1.3.1
Full Changelog: https://github.com/FriendsOfTYPO3/content-blocks/compare/1.3.0...1.3.1
[DOCS] Specify the path of the shell script. by @onza in https://github.com/FriendsOfTYPO3/content-blocks/pull/385
Full Changelog: https://github.com/FriendsOfTYPO3/content-blocks/compare/1.2.3...1.3.0
Full Changelog: https://github.com/FriendsOfTYPO3/content-blocks/compare/1.2.2...1.2.3
Full Changelog: https://github.com/FriendsOfTYPO3/content-blocks/compare/1.2.2...1.2.3
Full Changelog: https://github.com/FriendsOfTYPO3/content-blocks/compare/1.2.1...1.2.2
Full Changelog: https://github.com/FriendsOfTYPO3/content-blocks/compare/1.2.1...1.2.2
Nothing published for this version
[FEATURE] Type overrides by @nhovratov in https://github.com/FriendsOfTYPO3/content-blocks/pull/363
Full Changelog: https://github.com/FriendsOfTYPO3/content-blocks/compare/1.1.11...1.2.0
Nothing published for this version
[DOCS] FAQ added missing "not" by @wegewerk-mkb in https://github.com/FriendsOfTYPO3/content-blocks/pull/374
Full Changelog: https://github.com/FriendsOfTYPO3/content-blocks/compare/1.1.9...1.1.10
Full Changelog: https://github.com/FriendsOfTYPO3/content-blocks/compare/1.1.8...1.1.9
Full Changelog: https://github.com/FriendsOfTYPO3/content-blocks/compare/1.1.8...1.1.9
[TASK] Allow to reuse existing select fields by @nhovratov in https://github.com/FriendsOfTYPO3/content-blocks/pull/358
Full Changelog: https://github.com/FriendsOfTYPO3/content-blocks/compare/1.1.7...1.1.8
[TASK] Rename variable for layoutRootPaths by @mcmietz in https://github.com/FriendsOfTYPO3/content-blocks/pull/351
Full Changelog: https://github.com/FriendsOfTYPO3/content-blocks/compare/1.1.6...1.1.7
[DOCS] Migrate cards on startpage to new format by @linawolf in https://github.com/FriendsOfTYPO3/content-blocks/pull/334
Full Changelog: https://github.com/FriendsOfTYPO3/content-blocks/compare/1.1.5...1.1.6
Full Changelog: https://github.com/FriendsOfTYPO3/content-blocks/compare/1.1.4...1.1.5
Full Changelog: https://github.com/FriendsOfTYPO3/content-blocks/compare/1.1.4...1.1.5
[FIX] Deprecation Warning in ContentBlockBuilder by @tim-baecker in https://github.com/FriendsOfTYPO3/content-blocks/pull/329
Full Changelog: https://github.com/FriendsOfTYPO3/content-blocks/compare/1.1.3...1.1.4
Full Changelog: https://github.com/FriendsOfTYPO3/content-blocks/compare/1.1.2...1.1.3
Full Changelog: https://github.com/FriendsOfTYPO3/content-blocks/compare/1.1.2...1.1.3
Update Index.rst by @msattler007 in https://github.com/FriendsOfTYPO3/content-blocks/pull/321
Full Changelog: https://github.com/FriendsOfTYPO3/content-blocks/compare/1.1.1...1.1.2
Full Changelog: https://github.com/FriendsOfTYPO3/content-blocks/compare/1.1.0...1.1.1
Full Changelog: https://github.com/FriendsOfTYPO3/content-blocks/compare/1.1.0...1.1.1
[TASK] Add GitHub Templates for new issues by @PKuhlmay in https://github.com/FriendsOfTYPO3/content-blocks/pull/293
Full Changelog: https://github.com/FriendsOfTYPO3/content-blocks/compare/1.0.4...1.1.0
[DOCS] Make clear the templates need to go to folder templates by @linawolf in https://github.com/FriendsOfTYPO3/content-blocks/pull/286
Full Changelog: https://github.com/FriendsOfTYPO3/content-blocks/compare/1.0.3...1.0.4
Nothing published for this version
Full Changelog: https://github.com/FriendsOfTYPO3/content-blocks/compare/1.0.1...1.0.2
Full Changelog: https://github.com/FriendsOfTYPO3/content-blocks/compare/1.0.1...1.0.2
[TASK] Add specific example for setting cropvariants for a file by @PKuhlmay in https://github.com/FriendsOfTYPO3/content-blocks/pull/264
Full Changelog: https://github.com/FriendsOfTYPO3/content-blocks/compare/1.0.0...1.0.1
After 2.5 years since I joined forces with the Structured Content Initiative in TYPO3 Camp Mitteldeutschland in Dresden 2022 we finally can proudly an
After 2.5 years since I joined forces with the Structured Content Initiative in TYPO3 Camp Mitteldeutschland in Dresden 2022 we finally can proudly announce Content Blocks version 1.0.0 for TYPO3 v13 LTS (yeah!) 🎉 🎉 🎉 An incredible amount of work went into this project. This wouldn't have been possible without all of the people trying out early versions and give us valuable feedback. Many thanks for your trust! Your faith in us will now be rewarded with a smooth transition to the now stable version.
The most important change for you is the new vendor name of this package. The project moved to https://github.com/FriendsOfTYPO3 and thereby can now be installed by the name friendsoftypo3/content-blocks. It will now be further maintained by us, the Content Types team, but also by the Core team.
cd4e1d2 [!!!][TASK] Introduce AssetPathViewHelper
We replaced the custom AssetViewHelpers with a new AssetPathViewHelper. Now you can use the Core AssetViewHelpers and only use the custom ViewHelpers to build the path to your asset.
Before
<cb:asset.css identifier="cbAccordionCssBackend" file="EditorPreview.css"/>
After
<f:asset.css identifier="cbAccordionCssBackend" href="{cb:assetPath()}/EditorPreview.css"/>
ce8d8af [!!!][TASK] Replace custom TranslateViewHelper with LanguagePathViewHelper
We replaced the custom TranslateViewHelper with a LanguagePathViewHelper that is used to build the translation key.
Before
<cb:translate key="readmore"/>
After
<f:translate key="{cb:languagePath()}:readmore"/>
e2c003c [!!!][TASK] Integrate Record object into ContentBlockData Feature: #103783 - RecordTransformation Data Processor
One of the integrations into the Core include the new RecordObject feature. The switch caused some object accessors to change in Fluid.
{data._raw} ➡️ {data.rawRecord}{data.typeName} ➡️ {data.recordType}{data.tableName} ➡️ {data.mainType}{data.creationDate} ➡️ {data.systemProperties.createdAt}{data.updateDate} ➡️ {data.systemProperties.lastUpdatedAt}{data.localizedUid} ➡️ {data.computedProperties.localizedUid}dc1730d [!!!][TASK] Use Core RelationResolver (#225) Feature: #103581 - Automatically transform TCA field values for record objects
The relation resolving / expansion is now completely backed up by the Core. This lifts a heavy weight from Content Blocks as it is one of the most complex and important features. The switch shouldn't be too breaking. Only known hard changes are for type Folder. Instead of File objects, Folder objects are now returned. These are resolved recursively by default, so the option recursive is now obsolete.
Checking for existing type "Link" before:
<f:if condition="{data.link_field}">
<!-- -->
</f:if>
Checking for existing "Link" after:
<f:if condition="{data.link_field.url}">
<!-- -->
</f:if>
New way of accessing files from type "Folder":
<f:for each="{data.folder}" as="folder">
<f:for each="{folder.files}" as="image">
<f:image image="{item}" />
</f:for>
</f:for>
d96cbc5 [!!!][TASK] New Content Block folder structure (#248)
In order to align with modern guidelines, the Core strives to lift arbitrary rules for file names like UpperCamelCase for Fluid templates. Content Blocks now uses lowercase file names for all its pre-defined folders and files. Also, some files have been renamed. The new structure looks like this:
├── assets
│ └── icon.svg
├── language
│ └── labels.xlf
├── templates
| ├── partials
| | └── Component.html
│ ├── backend-preview.html
│ └── frontend.html
└── config.yaml
Partials and Layouts still have to be UpperCamelCase due to Fluid limitations.
Content Blocks has an upgrade wizard for easy migration:
typo3 upgrade:run contentBlocksFolderStructureMigration
3d01a7d [!!!][TASK] Use PHP attribute to register and configure Field Types (#255)
Field Types are now registered with PHP attributes. Have a look at the documentation to see how your class needs to be adjusted.
There are only a few new features, as the focus was on integrating crucial parts into the TYPO3 Core.
065409a [FEATURE] Field type "Pass" 4351148 [FEATURE] Previews for Record Types 480b246 [FEATURE] Allow to define custom icon for is site root state
Special thanks to @bmack, @o-ba and @bnf from the Core team who pushed the Core integration forward.
Huge thanks to my team @krausandre, @ManuS3009, @PKuhlmay, @jonaseberle and @filippos-gmk who are always there for bi-weekly calls and hear out my crazy ideas.
Honorable thanks to @typecat. Hey Liddy, we did it! Thanks so much for your dedicated effort in the past to spread Content Blocks into the world.
Thanks to all contributors, testers and early adopters of Content Blocks.
Nikita Hovratov - Content Blocks developer
[!!!][FEATURE] Transform Core Content Types to ContentBlockData objects ( #119 )
[FEATURE] Backend Previews for Nested Content
[FEATURE] Add caches for editor preview database operations
[FEATURE] Fieldtype Language ( #123 ) - thanks to @PKuhlmay
[FEATURE] Support for mixed relations in type Relation ( #120 )
[FEATURE] Custom properties for Select, Checkbox and Radio types ( #131 )
[BUGFIX] Allow empty items for FlexForm Select ( #131 )
[DOCS] Document the migration path for Mask
[DOCS] Add guide on how to add custom groups
And like always some bugfixes, documentation improvements and much much code refactoring along the way.
Nikita Hovratov - Content Blocks developer
DanielSiepmann and PKuhlmay
Full Changelog: https://github.com/nhovratov/content-blocks/compare/0.8.1...0.8.2
Full Changelog: https://github.com/nhovratov/content-blocks/compare/0.8.1...0.8.2
Full Changelog: https://github.com/nhovratov/content-blocks/compare/0.8.0...0.8.1
Full Changelog: https://github.com/nhovratov/content-blocks/compare/0.8.0...0.8.1
Content Blocks now supports TYPO3 v13 as a third-party extension. It is compatible with the 0.7 version for TYPO3 v12.
Content Blocks now supports TYPO3 v13 as a third-party extension. It is compatible with the 0.7 version for TYPO3 v12.
The Core is still working on the integration of Content Blocks. Content Blocks won't be a system extension, but an integral part of the Core. With the v13.2 release some important pre-patches have been merged to enable a smooth integration.
Full Changelog: https://github.com/FriendsOfTYPO3/content-blocks/compare/0.7.20...0.7.21
Full Changelog: https://github.com/FriendsOfTYPO3/content-blocks/compare/0.7.20...0.7.21
Full Changelog: https://github.com/FriendsOfTYPO3/content-blocks/compare/0.7.19...0.7.20
Full Changelog: https://github.com/FriendsOfTYPO3/content-blocks/compare/0.7.19...0.7.20
Full Changelog: https://github.com/FriendsOfTYPO3/content-blocks/compare/0.7.18...0.7.19
Full Changelog: https://github.com/FriendsOfTYPO3/content-blocks/compare/0.7.18...0.7.19
Full Changelog: https://github.com/FriendsOfTYPO3/content-blocks/compare/0.7.17...0.7.18
Full Changelog: https://github.com/FriendsOfTYPO3/content-blocks/compare/0.7.17...0.7.18
Full Changelog: https://github.com/nhovratov/content-blocks/compare/0.7.16...0.7.17
Full Changelog: https://github.com/nhovratov/content-blocks/compare/0.7.16...0.7.17
Full Changelog: https://github.com/nhovratov/content-blocks/compare/0.7.15...0.7.16
Full Changelog: https://github.com/nhovratov/content-blocks/compare/0.7.15...0.7.16
[DOCS] Add chapter about TypoScript by @peterkraume in https://github.com/nhovratov/content-blocks/pull/202
Full Changelog: https://github.com/nhovratov/content-blocks/compare/0.7.14...0.7.15
[BUG] - Custom FieldType LanguageFileRegistry error by @ondrejgrosko in https://github.com/nhovratov/content-blocks/pull/199
Full Changelog: https://github.com/nhovratov/content-blocks/compare/0.7.13...0.7.14
Full Changelog: https://github.com/nhovratov/content-blocks/compare/0.7.12...0.7.13
Full Changelog: https://github.com/nhovratov/content-blocks/compare/0.7.12...0.7.13
Full Changelog: https://github.com/nhovratov/content-blocks/compare/0.7.11...0.7.12
Full Changelog: https://github.com/nhovratov/content-blocks/compare/0.7.11...0.7.12
Full Changelog: https://github.com/nhovratov/content-blocks/compare/0.7.10...0.7.11
Full Changelog: https://github.com/nhovratov/content-blocks/compare/0.7.10...0.7.11
Full Changelog: https://github.com/nhovratov/content-blocks/compare/0.7.9...0.7.10
Full Changelog: https://github.com/nhovratov/content-blocks/compare/0.7.9...0.7.10
Full Changelog: https://github.com/nhovratov/content-blocks/compare/0.7.8...0.7.9
Full Changelog: https://github.com/nhovratov/content-blocks/compare/0.7.8...0.7.9
Full Changelog: https://github.com/nhovratov/content-blocks/compare/0.7.7...0.7.8
Full Changelog: https://github.com/nhovratov/content-blocks/compare/0.7.7...0.7.8
Now FlexForm select, radio and check labels can be maintained in Labels.xlf just like for normal fields. The generator command will take care to creat
Now FlexForm select, radio and check labels can be maintained in Labels.xlf just like for normal fields. The generator command will take care to create automatic entries.
Full Changelog: https://github.com/nhovratov/content-blocks/compare/0.7.5...0.7.6
Full Changelog: https://github.com/nhovratov/content-blocks/compare/0.7.5...0.7.6
Full Changelog: https://github.com/nhovratov/content-blocks/compare/0.7.4...0.7.5
Full Changelog: https://github.com/nhovratov/content-blocks/compare/0.7.4...0.7.5
Full Changelog: https://github.com/nhovratov/content-blocks/compare/0.7.3...0.7.4
Full Changelog: https://github.com/nhovratov/content-blocks/compare/0.7.3...0.7.4
Full Changelog: https://github.com/nhovratov/content-blocks/compare/0.7.2...0.7.3
Full Changelog: https://github.com/nhovratov/content-blocks/compare/0.7.2...0.7.3
Minimum TYPO3 version raised to 12.4.14
Minimum TYPO3 version raised to 12.4.14
Full Changelog: https://github.com/nhovratov/content-blocks/compare/0.7.1...0.7.2
Fixes an issue with deployment. Icons are now resolved after symlinked asset paths have been published.
Fixes an issue with deployment. Icons are now resolved after symlinked asset paths have been published.
Yes, this is the last minor version for now. Many last minute features got in, though. Now the focus will shift in preparing the Core patch. Developme
Yes, this is the last minor version for now. Many last minute features got in, though. Now the focus will shift in preparing the Core patch. Development of additional features will pause for this time. Of course, bug fix releases will be provided if needed. Now let's see what's changed!
We have worked on a JSON schema definition for Content Blocks and have now reached a good state. This is not only relevant for validation, but helps you write EditorInterface.yaml files with auto-completion if your IDE supports it. Many thanks to @PKuhlmay for helping me out there! You can find the separate repository containing the schemas here: https://github.com/nhovratov/content-blocks-json-schema There you can find information on how to include them in commonly used IDEs.
It is now possible to define a new Record Type for existing, native Record Types. You can for example add a custom type for News records. This is especially handy if there is need to extend the basic functionality of extensions with custom definitions and fields. Of course, this is only one part of multiple steps to achieve the final goal, but a major and annoying one. Read this guide for more information: https://docs.typo3.org/p/contentblocks/content-blocks/main/en-us/Guides/RecordTypes/Index.html#adding-new-types-to-existing-tables
Just like for Content Elements, you can now define previews for Page Types. The preview will be displayed on top of the content area. Everything works exactly like you already know it from the EditorPreview.html file of Content Elements. The screenshot is just an example of what it could look like and is not included by default. Special thanks to @DanielSiepmann again for pioneering this feature.
This is more of a developer feature. Nevertheless, it is important to be able to define custom Field Types for Content Blocks if special needs arise. With this feature it is possible to define funny things like a "Map Selector" or type "Money". Read more in this article: https://docs.typo3.org/p/contentblocks/content-blocks/main/en-us/DeveloperCorner/ExtendFieldTypes/Index.html
Up until now it was needed to use the f:cObject view helper to render nested content elements in the frontend. This is a bit confusing for many people. Also, it is weird to jump to TypoScript rendering within Fluid back and forth from a technical point of view. A more elegant solution is to pre-render child elements and just to output the content. This has now be accomplished. The rendered "grids" can now be accesed by {data._grids.identifier.content}. Read the updated guide for nested content for more insight: https://docs.typo3.org/p/contentblocks/content-blocks/main/en-us/Guides/NestedContentElements/Index.html#render-nested-content-elements-in-the-frontend
Again, credits to @DanielSiepmann for the idea.
The Content Blocks documentation rendering is now based on PHP. A BIG thanks to @linawolf for providing the patch. Not only is it now much faster, but a lot more accessible: https://docs.typo3.org/p/contentblocks/content-blocks/main/en-us/Index.html
At this point I also want to thank @garvinhicking for providing a redirect from an older version of the documentation to the current one.
And as always many code refactorings, documentation improvements and bugfixes. Thanks to all supporters and the valuable feedback! This would not be possible without you!
Nikita Hovratov - Content Blocks developer
Full Changelog: https://github.com/nhovratov/content-blocks/compare/0.6.3...0.6.4
Full Changelog: https://github.com/nhovratov/content-blocks/compare/0.6.3...0.6.4
Full Changelog: https://github.com/nhovratov/content-blocks/compare/0.6.2...0.6.3
Full Changelog: https://github.com/nhovratov/content-blocks/compare/0.6.2...0.6.3
Fix missing _raw for relations to none content block tables by @DanielSiepmann in https://github.com/nhovratov/content-blocks/pull/135
Full Changelog: https://github.com/nhovratov/content-blocks/compare/0.6.1...0.6.2
One column per quarter.