PHPackages                             friendsoftypo3/content-blocks - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility &amp; Helpers](/categories/utility)
4. /
5. friendsoftypo3/content-blocks

ActiveTypo3-cms-extension[Utility &amp; Helpers](/categories/utility)

friendsoftypo3/content-blocks
=============================

TYPO3 CMS Content Blocks - Content Types API | Define reusable components via YAML

2.1.3(2mo ago)96374.6k—3.6%41[45 issues](https://github.com/FriendsOfTYPO3/content-blocks/issues)[1 PRs](https://github.com/FriendsOfTYPO3/content-blocks/pulls)19GPL-2.0-or-laterPHPPHP ^8.2CI passing

Since Sep 27Pushed 1mo ago12 watchersCompare

[ Source](https://github.com/FriendsOfTYPO3/content-blocks)[ Packagist](https://packagist.org/packages/friendsoftypo3/content-blocks)[ Docs](https://typo3.org)[ RSS](/packages/friendsoftypo3-content-blocks/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (10)Dependencies (53)Versions (107)Used By (19)

[![TYPO3 compatibility](https://camo.githubusercontent.com/9884fdd1f207fa32374b8dbf96f176b75a6b51eaf9866091cf3c8bcc7096d1e5/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5459504f332d31322e342d6666383730303f6d61784167653d33363030266c6f676f3d7479706f33)](https://get.typo3.org/)[![TYPO3 compatibility](https://camo.githubusercontent.com/fc47d6edb7035908e2db102ae2c05d22110b6681c21fe7ed9677bc454dbad775/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5459504f332d31332e342d6666383730303f6d61784167653d33363030266c6f676f3d7479706f33)](https://get.typo3.org/)[![TYPO3 compatibility](https://camo.githubusercontent.com/afccd5008a60753a28de0e916c445ed30f3e0a3eec8d0831434e124d85ffd937/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5459504f332d31342e302d6666383730303f6d61784167653d33363030266c6f676f3d7479706f33)](https://get.typo3.org/)

TYPO3 CMS Content Blocks
========================

[](#typo3-cms-content-blocks)

This is the standalone repository for the TYPO3 Content Blocks project. Content Blocks provides a new API to create custom Content Types like Content Elements, Page Types or generic Record Types. Use it now in your TYPO3 v13/v14 project and eventually this will become a Core feature in TYPO3 v15 LTS.

URL**Repository:****Documentation:****TER:**[https://extensions.typo3.org/extension/content\_blocks](https://extensions.typo3.org/extension/content_blocks)**Packagist:****Examples:**[https://github.com/friendsoftypo3/content-blocks/tree/main/Build/content\_blocks\_examples](https://github.com/friendsoftypo3/content-blocks/tree/main/Build/content_blocks_examples)Installation
------------

[](#installation)

Require this package via composer:

```
composer req friendsoftypo3/content-blocks

```

Or install it via the Extension Manager in the TYPO3 backend. The extension key is `content_blocks`.

Usage
-----

[](#usage)

Refer to the [Documentation](https://docs.typo3.org/p/friendsoftypo3/content-blocks/main/en-us)on how to use the Content Blocks API.

Feedback and Support
--------------------

[](#feedback-and-support)

You can reach us on the [TYPO3 Slack](https://typo3.org/community/meet/chat-slack)channel `#cig-structuredcontent`. We appreciate any constructive feedback and will help you, if you have any problems.

JSON Schema
-----------

[](#json-schema)

Enable validation and auto-completion with [JSON schema](https://github.com/FriendsOfTYPO3/content-blocks/tree/main/JsonSchema)

Developing
----------

[](#developing)

There is a ddev setup ready to use. Ensure [ddev](https://github.com/ddev/ddev)is installed on your machine. Then run:

```
ddev start
ddev composer install
touch .Build/public/FIRST_INSTALL
ddev launch

```

The default URL is . Continue with the TYPO3 installation process.

Testing
-------

[](#testing)

First install the composer dependencies:

```
composer install

```

Then run unit or functional tests by executing:

```
Build/Scripts/runTests.sh -s unit
Build/Scripts/runTests.sh -s functional

```

### Hint

[](#hint)

Be sure to exclude the `.Build/public/typo3temp` directory from indexing in your IDE (e.g. PhpStorm) before starting the tests.

Rendering the documentation
---------------------------

[](#rendering-the-documentation)

When you update the documentation you can try out rendering it locally (Docker required):

```
make docs

```

You can test if the syntax and references are ok with

```
make test-docs

```

Roadmap 2024
------------

[](#roadmap-2024)

MilestoneDate[Content Blocks v0.6](https://github.com/friendsoftypo3/content-blocks/releases/tag/0.6.0)26.02[Content Blocks v0.7](https://github.com/friendsoftypo3/content-blocks/releases/tag/0.7.0)01.04[Core patch](https://review.typo3.org/c/Packages/TYPO3.CMS/+/83721)01.04 - 23.04[TYPO3 v13.1](https://typo3.org/article/typo3-v131-the-surfers-starterkit)23.04[Review period](https://review.typo3.org/c/Packages/TYPO3.CMS/+/83721/19)23.04 - 14.06[TYPO3 v13.2](https://typo3.org/article/typo3-v132-ready-set-ride)02.07[Content Blocks compatibility v13](https://github.com/friendsoftypo3/content-blocks/releases/tag/0.8.0)11.07[Content Blocks (partly) Core integration](https://typo3.org/article/typo3-v133-prepare-for-the-fun)17.09[Content Blocks 1.0](https://github.com/friendsoftypo3/content-blocks/releases/tag/1.0.0)15.10

###  Health Score

64

—

FairBetter than 99% of packages

Maintenance80

Actively maintained with recent releases

Popularity54

Moderate usage in the ecosystem

Community44

Growing community involvement

Maturity72

Established project with proven stability

 Bus Factor1

Top contributor holds 83.3% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~8 days

Recently: every ~1 days

Total

105

Last Release

63d ago

Major Versions

1.3.18 → 2.0.02025-11-25

1.3.19 → 2.0.42026-01-21

1.4.0 → 2.1.02026-03-13

1.4.1 → 2.1.22026-03-13

1.4.3 → 2.1.32026-03-16

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/165630?v=4)[Benni Mack](/maintainers/bmack)[@bmack](https://github.com/bmack)

![](https://avatars.githubusercontent.com/u/402145?v=4)[Oliver Hader](/maintainers/ohader)[@ohader](https://github.com/ohader)

![](https://www.gravatar.com/avatar/4cfa2947b747549a4a243bb85545139173cc6822551468c9aed931baeb8bc0bc?d=identicon)[friendsoftypo3](/maintainers/friendsoftypo3)

![](https://www.gravatar.com/avatar/46663553a22f0c1daf03e2defcabdf6c1f8f1aada7aff2e0b5c503c63cd236e1?d=identicon)[nhovratov](/maintainers/nhovratov)

---

Top Contributors

[![nhovratov](https://avatars.githubusercontent.com/u/19343425?v=4)](https://github.com/nhovratov "nhovratov (1370 commits)")[![krausandre](https://avatars.githubusercontent.com/u/42275455?v=4)](https://github.com/krausandre "krausandre (145 commits)")[![ManuS3009](https://avatars.githubusercontent.com/u/43109656?v=4)](https://github.com/ManuS3009 "ManuS3009 (44 commits)")[![SteffenMaechtel-NB](https://avatars.githubusercontent.com/u/57707778?v=4)](https://github.com/SteffenMaechtel-NB "SteffenMaechtel-NB (16 commits)")[![PKuhlmay](https://avatars.githubusercontent.com/u/107543296?v=4)](https://github.com/PKuhlmay "PKuhlmay (10 commits)")[![linawolf](https://avatars.githubusercontent.com/u/48202465?v=4)](https://github.com/linawolf "linawolf (7 commits)")[![DanielSiepmann](https://avatars.githubusercontent.com/u/354250?v=4)](https://github.com/DanielSiepmann "DanielSiepmann (6 commits)")[![peterkraume](https://avatars.githubusercontent.com/u/4234704?v=4)](https://github.com/peterkraume "peterkraume (5 commits)")[![jonaseberle](https://avatars.githubusercontent.com/u/1678001?v=4)](https://github.com/jonaseberle "jonaseberle (5 commits)")[![typecat](https://avatars.githubusercontent.com/u/30155820?v=4)](https://github.com/typecat "typecat (4 commits)")[![garvinhicking](https://avatars.githubusercontent.com/u/273326?v=4)](https://github.com/garvinhicking "garvinhicking (4 commits)")[![o-ba](https://avatars.githubusercontent.com/u/8812114?v=4)](https://github.com/o-ba "o-ba (4 commits)")[![CKussin](https://avatars.githubusercontent.com/u/49631108?v=4)](https://github.com/CKussin "CKussin (3 commits)")[![georg-tiefenbrunn](https://avatars.githubusercontent.com/u/4973460?v=4)](https://github.com/georg-tiefenbrunn "georg-tiefenbrunn (3 commits)")[![steffenmaechtel](https://avatars.githubusercontent.com/u/607626?v=4)](https://github.com/steffenmaechtel "steffenmaechtel (2 commits)")[![ondrejgrosko](https://avatars.githubusercontent.com/u/142219522?v=4)](https://github.com/ondrejgrosko "ondrejgrosko (2 commits)")[![thommyhh](https://avatars.githubusercontent.com/u/13288620?v=4)](https://github.com/thommyhh "thommyhh (2 commits)")[![luko72](https://avatars.githubusercontent.com/u/10597743?v=4)](https://github.com/luko72 "luko72 (1 commits)")[![georgringer](https://avatars.githubusercontent.com/u/1905663?v=4)](https://github.com/georgringer "georgringer (1 commits)")[![sascha-egerer](https://avatars.githubusercontent.com/u/1651414?v=4)](https://github.com/sascha-egerer "sascha-egerer (1 commits)")

---

Tags

contentelementstypestypo3

###  Code Quality

Static AnalysisPHPStan

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/friendsoftypo3-content-blocks/health.svg)

```
[![Health](https://phpackages.com/badges/friendsoftypo3-content-blocks/health.svg)](https://phpackages.com/packages/friendsoftypo3-content-blocks)
```

###  Alternatives

[simplesamlphp/simplesamlphp

A PHP implementation of a SAML 2.0 service provider and identity provider.

1.1k12.4M193](/packages/simplesamlphp-simplesamlphp)[shopware/platform

The Shopware e-commerce core

3.3k1.5M3](/packages/shopware-platform)[sulu/sulu

Core framework that implements the functionality of the Sulu content management system

1.3k1.3M152](/packages/sulu-sulu)[prestashop/prestashop

PrestaShop is an Open Source e-commerce platform, committed to providing the best shopping cart experience for both merchants and customers.

9.0k15.4k](/packages/prestashop-prestashop)[symplify/monorepo-builder

Not only Composer tools to build a Monorepo.

5205.3M82](/packages/symplify-monorepo-builder)[drupal/core-recommended

Locked core dependencies; require this project INSTEAD OF drupal/core.

6939.5M343](/packages/drupal-core-recommended)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
