# Thème bloc

> Un thème WordPress dont les gabarits sont entièrement composés de blocs, éditables visuellement dans l'éditeur de site sans écrire de PHP.

- Auteur : Clément Hadrot
- Publié le : 2026-09-25
- Mis à jour le : 2026-09-25
- URL : https://wpmoderne.dev.wordpress-developpement.fr/lexique/theme-bloc/

Longtemps, personnaliser la structure d'un thème WordPress exigeait de modifier des fichiers PHP à la main. Le thème bloc change cette donne : chaque gabarit est écrit en syntaxe de blocs, la même que celle utilisée pour composer le contenu des articles, et devient donc modifiable directement depuis l'éditeur de site.

## Ce qui distingue sa structure

Un thème bloc remplace les fichiers PHP de gabarits par des fichiers HTML au format blocs placés dans `templates/` et `parts/`, et centralise ses réglages et styles dans `theme.json` plutôt que dans le Personnaliseur ou un `style.css` traditionnel. La présence d'un dossier `templates/` avec au minimum un fichier `index.html` signale à WordPress qu'il s'agit d'un thème bloc.

## Exemple minimal de gabarit

```
<!-- wp:template-part {"slug":"header","tagName":"header"} /-->
<!-- wp:group {"tagName":"main"} -->
<main class="wp-block-group"><!-- wp:post-content /--></main>
<!-- /wp:group -->
<!-- wp:template-part {"slug":"footer","tagName":"footer"} /-->
```

## À ne pas confondre avec

- Un thème classique peut utiliser l'éditeur de blocs pour le contenu des articles sans pour autant être un thème bloc : la différence se situe dans la structure même des gabarits, pas dans l'éditeur de contenu.
- Un thème hybride combine les deux approches, en gardant certains gabarits PHP tout en adoptant partiellement `theme.json` et les parties de gabarit.
- Un thème bloc n'exclut pas forcément tout code PHP : des fonctionnalités avancées peuvent toujours passer par un `functions.php` minimal en complément.
