docs(troubleshooting): avoid blank PDFs with Chromium

gotenberg · Jan 27, 2025 · a176163 · a176163
1 parent 1afb62d
commit a176163
Show file tree

Hide file tree

Showing 2 changed files with 6 additions and 1 deletion.
diff --git a/docs/routes.mdx b/docs/routes.mdx
@@ -951,7 +951,6 @@ Each route accepts the following form field:
 | skipNetworkIdleEvent | Do not wait for Chromium network to be idle. | true    |
 
 By default, Gotenberg does not wait for the network idle event, significantly speeding up the conversion process.
-Although Chromium triggers this event heuristically, it is often — if not always — fired too late for page rendering.
 
 :::warning
 

diff --git a/docs/troubleshooting.mdx b/docs/troubleshooting.mdx
@@ -42,6 +42,12 @@ commonly suggested solution, but it may not be enough. This is a [known bug](htt
 
 For additional details, refer to issue [#788](https://github.com/gotenberg/gotenberg/issues/788).
 
+### Blank PDFs
+
+Before Gotenberg *8.11.0*, the `skipNetworkIdleEvent` form field defaulted to *false*.
+Now, by default, Gotenberg skips waiting for the network idle event, which speeds up the conversion process.
+However, if you have upgraded to a newer version and are experiencing blank PDFs, set this field to *false*.
+
 ### Dealing with Timeouts {#timeouts-chromium}
 
 If you are experiencing timeouts (i.e., *503 Service Unavailable*), consider the following steps to troubleshoot your issue: