From 96aa2451bf39c91a5bb2ae89c69a3986878a7d0a Mon Sep 17 00:00:00 2001
From: shamoon <4887959+shamoon@users.noreply.github.com>
Date: Mon, 28 Aug 2023 19:29:36 -0700
Subject: [PATCH] Add Ghostscript error to troubleshooting docs

---
 docs/troubleshooting.md | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/docs/troubleshooting.md b/docs/troubleshooting.md
index 63e37a10f..baf91a27c 100644
--- a/docs/troubleshooting.md
+++ b/docs/troubleshooting.md
@@ -345,3 +345,11 @@ STATEMENT:  INSERT INTO "documents_tag" ("owner_id", "name", "match", "matching_
 
 This can happen during heavy consumption when using polling. Paperless will handle it correctly and the file
 will still be consumed
+
+## Consumption fails with "Ghostscript PDF/A rendering failed"
+
+Newer versions of OCRmyPDF will fail if it encounters errors during processing.
+This is intentional as the output archive file may differ in unexpected or undesired
+ways from the original. As the logs indicate, if you encounter this error you can set
+`PAPERLESS_OCR_USER_ARGS: '{"continue_on_soft_render_error": true}'` to try to 'force'
+processing documents with this issue.