# Brouillon

> Statut de publication attribué à un contenu enregistré mais non diffusé publiquement, modifiable et visible uniquement par les comptes habilités.

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

Rédiger rarement se fait d'un seul jet : on note une idée, on la laisse reposer, on y revient le lendemain. WordPress a été pensé pour ce va-et-vient, avec un état intermédiaire entre la page blanche et la mise en ligne.

## Ce qui se passe dans la base de données

Un article prend cet état lorsque la colonne `post_status` de la table `wp_posts` vaut `draft`. Un cas particulier existe : lorsqu'un article n'a jamais été enregistré volontairement par l'utilisateur mais seulement par la sauvegarde automatique de l'éditeur, WordPress utilise le statut `auto-draft`, purgé au bout de sept jours par la tâche planifiée `wp_scheduled_delete`.

Le passage vers la publication déclenche le hook `draft_to_publish`, l'un des nombreux hooks de transition générés automatiquement par `wp_transition_post_status()` selon le schéma `{ancien_statut}_to_{nouveau_statut}`.

## Exemple : créer un brouillon en PHP

```
<?php
wp_insert_post( array(
    'post_title'   => 'Idée à retravailler',
    'post_status'  => 'draft',
    'post_type'    => 'post',
) );
```

## Pièges fréquents

- Un brouillon n'est pas indexé et ne possède pas de permalien fonctionnel côté public : la seule façon de le consulter légitimement est l'aperçu.
- Certaines extensions de sitemap XML excluent correctement les brouillons, mais d'autres, mal codées, interrogent `WP_Query` sans filtrer `post_status` et les font fuiter.
- Un brouillon peut appartenir à n'importe quel type de contenu personnalisé, pas seulement aux articles : la logique de statut est indépendante du type de publication.
- La révision associée à un brouillon reste consultable dans l'historique des révisions, ce qui permet de comparer deux versions successives avant de trancher laquelle publier.
