# Hiérarchie des gabarits

> Le système de règles ordonnées selon lequel WordPress choisit quel fichier de gabarit utiliser pour afficher un type de contenu donné.

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

Face à une requête entrante, WordPress ne demande jamais au thème « quel fichier dois-je utiliser ? » : il applique un ordre de priorité fixe, du plus spécifique au plus générique, et retient le premier fichier trouvé dans le thème actif qui correspond à cet ordre.

## Logique générale de sélection

Pour un article de type « produit » et de slug « chaise-oslo », la recherche suit typiquement cette séquence : `single-produit-chaise-oslo.php`, puis `single-produit.php`, puis `single.php`, puis `singular.php`, et enfin `index.php` en dernier filet de sécurité. Cette même logique s'applique, avec des noms de fichiers différents, aux pages, archives, résultats de recherche et pages d'erreur 404.

## Vérifier quel gabarit est utilisé

```
// À placer temporairement dans functions.php
add_action( 'wp_footer', function () {
    global $template;
    echo '';
} );
```

Ce commentaire HTML, visible dans le code source, confirme quel fichier a réellement été chargé.

## Différence entre thèmes classiques et thèmes blocs

- Un thème classique résout cette hiérarchie via des fichiers PHP recherchés dans son dossier ; un thème bloc la résout via des fichiers HTML placés dans `templates/`, avec une logique de correspondance équivalente mais un moteur de résolution distinct.
- Un thème enfant peut fournir une surcharge de gabarit qui prend systématiquement le pas sur le fichier équivalent du thème parent, sans modifier ce dernier.
- Une extension peut elle aussi injecter des gabarits dans cette hiérarchie via le filtre `template_include`, ce qui explique pourquoi certains plugins de type CPM affichent leurs propres mises en page.