2.1 

Content Blocks version 2.1 introduces a complete JSON Schema for all Content Block types.

This feature was voted for as part of the Community Budget Ideas 2026 Round One

Feature 

JSON Schema 

Since Content Blocks is based on a YAML definition, it is possible to validate it against a JSON Schema. The schema is shipped directly inside the Content Blocks extension and updated in each new releases accordingly. It is located in the root folder "JsonSchema":

  • content-blocks

    • JsonSchema

      • basic.schema.json
      • content-element.schema.json
      • file-type.schema.json
      • page-type.schema.json
      • record-type.schema.json

As you can see, each content type brings its own schema. Even Basics have their own schema, as they are separate YAML files.

Learn how to use it in your IDE here.

Lint Command 

The most simple usage is the integrated lint command:

vendor/bin/typo3 content-blocks:lint
Copied!

Running this command will reveal configuration errors of all loaded Content Blocks. Use this in your CI pipeline to ensure you don't introduce incorrect configuration.