Drupal 8 core does not provide support for theme suggestions for custom block type Twig templates.
Having a theme suggestion tied to the type of block is a very simple way to provide modular design components, affording consistent patterns per block type driven through Drupal's block system. This can be used with the standard block placement, Panels, or any other system that leverages blocks. Advanced supported cases include the use of the Components module, which can afford more granular, reusable templates included within other templates.
This module provides the following theme suggestion based on the Twig naming convention:
block--block-content-{{ machine-name-of-block-type }}.html.twig
For example, a custom block type with machine name testing_this_out would now have a corresponding template suggestion for all blocks of that type block--block-content-testing-this-out.html.twig.
The Twig template assumes all of the standard markup found in all other the block templates, including the corresponding fields of that block type.
Note that the Drupal 10.3+ version supports block suggestions by itself. Here is the change record - https://www.drupal.org/node/3304793
Project information
- Project categories: Content display
1,701 sites report using this module
- Created by nerdstein on , updated
Stable releases for this project are covered by the security advisory policy.
Look for the shield icon below.
Releases
Development version: 8.x-1.x-dev updated 6 Aug 2025 at 09:07 UTC

