# Doctype

> Déclaration placée en toute première ligne d'un document HTML qui indique au navigateur d'utiliser le mode de rendu standard plutôt qu'un mode dégradé hérité du passé.

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

Sans cette ligne, certains navigateurs basculent silencieusement dans un mode dit « quirks », hérité des années 1990, qui reproduit d'anciens comportements incohérents pour ne pas casser de très vieilles pages web. Autant dire une source de bugs difficiles à diagnostiquer sur un site moderne.

## Une seule forme à retenir

Contrairement aux anciennes versions de HTML qui imposaient une chaîne complexe référençant une définition de type de document, HTML5 a radicalement simplifié cette déclaration :

```
<!DOCTYPE html>
<html lang="fr">
<head>
  <meta charset="UTF-8">
</head>
<body>
</body>
</html>
```

Tous les gabarits fournis par un thème WordPress démarrent par cette même ligne, générée dans le fichier `header.php` ou, pour les thèmes à blocs, dans le fichier de gabarit racine géré par le système FSE.

## Bon à savoir

- Le doctype n'est ni sensible à la casse ni suivi d'un attribut de fermeture ; il ne s'agit d'ailleurs pas techniquement d'une balise HTML mais d'une instruction destinée au moteur de rendu.
- Un doctype absent ou mal placé, par exemple précédé d'un espace ou d'un commentaire, peut suffire à faire basculer la page en mode quirks.
- Le mode quirks affecte notamment le calcul des dimensions des boîtes CSS, ce qui peut expliquer des mises en page qui se comportent différemment d'un navigateur à un autre sans raison apparente.
- Un document sans doctype reste parfaitement valide du point de vue du navigateur qui l'affiche quand même, mais un validateur HTML le signalera systématiquement comme une erreur de conformité.
