# front-page.html, home.html et index.html : qui affiche quoi dans un thème bloc

> Trois fichiers, trois rôles distincts pour la page d'accueil d'un thème bloc, selon les réglages de lecture choisis. Décryptage des cas qui piègent régulièrement les débutants.

- Auteur : Clément Hadrot
- Publié le : 2023-09-29
- Mis à jour le : 2023-09-29
- Catégorie : FSE
- URL : https://wpmoderne.dev.wordpress-developpement.fr/fse/front-page-home-index-html-theme-bloc-hierarchie/

## L’essentiel

- front-page.html prime toujours si présent
- home.html cible spécifiquement le flux du blog
- Les réglages de lecture déterminent lequel s'applique réellement

Une question revient régulièrement de la part de développeurs qui découvrent les thèmes bloc : pourquoi, en modifiant `front-page.html`, rien ne change sur la page d'accueil du site ? La réponse tient presque toujours dans les réglages de lecture, une source de confusion qui existait déjà avec les thèmes classiques mais que l'absence de fichiers PHP familiers rend parfois plus difficile à diagnostiquer.

Ce billet ne couvre volontairement que ce cas précis de la page d'accueil : la hiérarchie complète de résolution des templates dans un thème bloc mériterait, à elle seule, un article bien plus long.

## Les deux configurations possibles des réglages de lecture

Tout commence dans **Réglages > Lecture**, où deux options s'offrent à l'administrateur du site : afficher « Vos derniers articles » en page d'accueil, ou afficher « Une page statique », avec un choix explicite de la page d'accueil et, éventuellement, d'une page distincte pour les articles.

## Cas 1 : affichage des derniers articles

> L'essentiel à retenir : front-page.html prime toujours si présent ; home.html cible spécifiquement le flux du blog ; Les réglages de lecture déterminent lequel s'applique réellement

Quand l'option « Vos derniers articles » est sélectionnée, WordPress cherche en priorité un fichier `home.html`. En son absence, il se rabat sur `index.html`. Dans cette configuration, le fichier `front-page.html`, même s'il existe dans le thème, n'est tout simplement jamais utilisé.

## Cas 2 : une page statique définie comme page d'accueil

Quand une page statique est choisie comme page d'accueil, la hiérarchie change de priorité : WordPress cherche d'abord `front-page.html`. C'est ce fichier, et lui seul, qui détermine alors l'apparence de la page d'accueil, indépendamment du contenu réel de la page statique sélectionnée — sauf si ce template inclut explicitement le bloc Contenu de la publication pour afficher ce contenu.

### Et la page des articles dans ce cas ?

Si une page distincte a été désignée pour afficher les articles récents, c'est le fichier `home.html` qui prend le relais pour cette page précise, avec le même mécanisme de repli vers `index.html` en son absence.

## Tableau récapitulatif

| Réglage de lecture | Template recherché en priorité | Repli si absent |
| --- | --- | --- |
| Derniers articles en accueil | home.html | index.html |
| Page statique en accueil | front-page.html | index.html |
| Page statique + page d'articles distincte | home.html (pour la page d'articles) | index.html |

## Les erreurs les plus fréquentes rencontrées

- Modifier `front-page.html` alors que le site affiche encore les derniers articles en accueil, sans effet visible.
- Oublier de créer `home.html` quand une page d'articles distincte a été définie, ce qui fait retomber sur `index.html` sans qu'on comprenne pourquoi.
- Confondre le contenu de la page statique choisie en accueil avec le contenu du template `front-page.html`, qui sont deux choses distinctes.

## Vérifier rapidement quel template est réellement utilisé

Pour lever le doute sans deviner, l'éditeur de site indique, lors de l'édition d'un template, le contexte auquel il s'applique. Une astuce plus rapide encore consiste à consulter l'écran **Apparence > Éditeur > Templates**, où chaque entrée précise, sous son nom, un court descriptif de son usage (« Utilisé comme page d'accueil du site », par exemple). C'est souvent le moyen le plus direct de confirmer quel fichier gouverne réellement l'apparence de la page d'accueil, sans avoir à tester chaque combinaison de réglages manuellement.

## En résumé

Le nombre de fichiers impliqués peut sembler excessif pour un seul emplacement du site, mais chacun répond à une configuration précise des réglages de lecture. Avant de chercher un bug dans le code d'un thème bloc dont la page d'accueil semble ignorer les modifications, un simple coup d'œil à ces réglages permet souvent de résoudre le mystère en quelques secondes.