Pourquoi mon Document PDFMonkey est-il vide ?

Dernière mise à jour le 23 mars 2026

Un document vide signifie généralement que PDFMonkey a généré le document avec succès, mais que le résultat ne contient aucun contenu visible. La cause la plus fréquente est un template non publié.

Le template n’est pas publié

C’est de loin la cause la plus courante. Les templates PDFMonkey possèdent deux versions de leur contenu : un brouillon (ce que vous éditez) et une version publiée (ce que PDFMonkey utilise pour générer les documents). Si vous n’avez jamais cliqué sur Publish, le contenu publié est vide et chaque document généré à partir de ce template sera vierge.

Comment corriger

  1. Ouvrez votre template dans l’éditeur (Dashboard ou Builder).
  2. Cliquez sur le bouton Publish.
  3. Relancez la génération du document.

Publiez après chaque modification

Cliquer sur Publish copie le brouillon actuel vers la version publiée. Si vous modifiez votre template sans republier, les documents continuent d’utiliser l’ancien contenu publié. Pensez toujours à publier après avoir effectué des modifications que vous souhaitez voir apparaître dans les documents générés.
Pour un guide complet du workflow template-vers-document, consultez De zéro à votre premier Document.

La logique conditionnelle masque tout le contenu

Si votre template enveloppe le contenu dans des blocs conditionnels, le résultat peut être vide lorsque les conditions ne sont pas remplies.

Les templates Code utilisent la syntaxe Liquid :

{% if items.size > 0 %}
  <!-- contenu ici -->
{% endif %}

Si items est absent du payload ou est un tableau vide, rien ne s’affiche.

Les templates Builder utilisent des règles de visibilité sur les composants. Si une condition de visibilité s’évalue à faux pour chaque composant, la page apparaît vide.

Comment corriger

  • Comparez les noms de variables dans vos conditions avec les clés de votre payload. Une faute de frappe ou une différence de casse (Items au lieu de items) fait échouer la condition silencieusement.
  • Testez avec le payload que vous envoyez réellement, pas uniquement les données de test du template.
  • Supprimez temporairement les conditions pour vérifier que le contenu s’affiche sans elles, puis réintroduisez-les une par une.

Une erreur JavaScript ou d’expression dans un template Builder

Les templates Builder peuvent échouer silencieusement lorsqu’ils contiennent une erreur à l’exécution. Deux scénarios courants :

  • Bibliothèques JavaScript externes ou code personnalisé dans des blocs HTML. Si un script lève une erreur non interceptée, le rendu peut s’interrompre et produire un document vide.
  • Erreurs de syntaxe dans les conditions ou les répétitions. Une faute de frappe dans une condition de visibilité ou une expression de répétition (par exemple une parenthèse manquante ou une variable mal orthographiée) empêche le composant de s’évaluer, ce qui peut produire un résultat vide.

Comment corriger

  1. Ouvrez le template dans le Builder et vérifiez l’aperçu. Si l’aperçu lui-même est vide ou cassé, l’erreur se trouve dans la logique du template.
  2. Examinez les blocs HTML contenant des balises <script>. Essayez de les supprimer temporairement pour isoler le problème.
  3. Relisez les expressions de condition et de répétition de vos composants à la recherche de fautes de frappe ou d’erreurs de syntaxe.
  4. Si vous utilisez des bibliothèques externes chargées via une URL CDN, vérifiez que l’URL est correcte et que la bibliothèque est accessible au moment de la génération.

Pour déboguer, réduisez le template à sa forme la plus simple (texte statique, aucun script, aucune condition) et confirmez qu’il se génère correctement. Ajoutez ensuite la complexité élément par élément pour identifier ce qui casse.

Le payload est vide ou manquant

Si vous créez un document sans fournir de payload (ou avec "payload": {}), chaque variable du template est évaluée comme vide. Quand le template ne contient aucun contenu statique, le résultat est un document vierge.

Comment corriger

Assurez-vous que votre requête API inclut un payload avec les données attendues par votre template :

{
  "document": {
    "document_template_id": "YOUR_TEMPLATE_ID",
    "status": "pending",
    "payload": {
      "name": "Jane Doe",
      "items": [{ "description": "Widget", "price": 9.99 }]
    }
  }
}

Consultez Mes données n’apparaissent pas pour en savoir plus sur les décalages entre payload et variables du template.

Le CSS masque le contenu

Des règles CSS peuvent rendre le contenu invisible sans le supprimer du HTML. Causes fréquentes :

  • display: none ou visibility: hidden sur un élément englobant
  • Texte blanc (ou transparent) sur fond blanc
  • opacity: 0 sur un conteneur
  • Un élément positionné hors page avec position: absolute et des décalages négatifs importants

Comment corriger

  1. Ouvrez l’éditeur de template et vérifiez l’onglet CSS à la recherche de règles susceptibles de masquer le contenu.
  2. Utilisez l’aperçu en direct pour confirmer que le contenu s’affiche comme prévu.
  3. Si vous utilisez des classes CSS conditionnelles, vérifiez que les données du payload activent la bonne classe.

Questions fréquentes

Je vois du contenu dans l’aperçu mais le document généré est vide.

L’aperçu utilise la version brouillon de votre template, tandis que la génération utilise la version publiée. Cliquez sur Publish dans l’éditeur de template et relancez la génération.

J’ai publié mon template, mais seul l’ancien contenu apparaît.

Vous avez probablement modifié le template après l’avoir publié. Chaque fois que vous modifiez le brouillon, vous devez cliquer de nouveau sur Publish pour reporter ces changements vers la version publiée.

Mon template Builder génère un document vide alors que l’aperçu est correct.

Vérifiez que vous avez publié le template depuis le Dashboard (pas simplement sauvegardé dans le Builder). Vérifiez également que les règles de visibilité de vos composants s’évaluent correctement avec le payload que vous envoyez via l’API.

Questions fréquentes

Pourquoi mon document PDFMonkey est-il vide ?
La cause la plus fréquente est un template non publié. PDFMonkey utilise la version publiée d’un template pour générer les documents. Si vous n’avez jamais cliqué sur Publier, le contenu publié est vide et le document généré sera vierge.
Comment publier un template dans PDFMonkey ?
Ouvrez votre template dans l’éditeur et cliquez sur le bouton Publish. Cela copie le contenu brouillon (HTML, CSS, paramètres) vers la version publiée que PDFMonkey utilise pour la génération. Vous devez publier à nouveau après chaque modification que vous souhaitez voir apparaître dans les documents générés.
Mon template est publié mais le document est toujours vide. Quelle autre cause possible ?
Autres causes possibles : une logique conditionnelle (blocs Liquid if/unless ou règles de visibilité du Builder) qui masque tout le contenu quand les données du payload ne correspondent pas ; des erreurs JavaScript ou des erreurs de syntaxe dans les conditions et répétitions du Builder ; un payload vide ou manquant ; des règles CSS comme display:none ou visibility:hidden ; ou du texte blanc sur fond blanc.
Navigation