Troubleshoot PDF Loading and Analysis

Problems adding or analyzing a PDF are often related to file access, document format, encryption, or the location where the file is stored. PDFSanitize provides status information and activity-log messages that can help you identify what happened.

When investigating a problem, begin with the affected document rather than repeatedly processing an entire batch. Working with one PDF makes it easier to determine whether the issue is specific to the file or the environment.

A PDF does not appear in the list

If a document does not appear after using Add Folder, confirm that it has a .pdf extension and is located inside the selected directory or one of its normal subfolders.

PDFSanitize searches subfolders recursively but does not follow directory junctions or symbolic directory links. A PDF that can only be reached through one of those links may therefore not be discovered during folder import.

The application also avoids duplicate entries for the same full source path. If the file was already added, it will not appear as a second row simply because you import the folder again.

If the missing PDF is in a folder you cannot access, check your Windows permissions. PDFSanitize attempts to continue past inaccessible subfolders where possible and records relevant access problems in the activity log.

You can also try adding the file directly with Add PDF(s). This helps determine whether the issue concerns folder discovery or access to the PDF itself.

Analysis fails for a document

A PDF may fail analysis if it is damaged, incomplete, inaccessible, or contains structures that cannot be inspected successfully.

Start by confirming that the source file still exists and opens normally in a PDF viewer. If it is stored on a network share, copy it to an authorized local working folder to determine whether the problem involves network access or file locking.

Also check that the document is genuinely a PDF rather than another file type that was renamed with a .pdf extension. A filename extension alone does not guarantee that the file contains valid PDF data.

Once you have checked the source, select only the affected document and run Analyze again. If analysis still fails, record the error message and relevant activity-log information for further investigation.

The document is marked Encrypted

PDFSanitize can identify encrypted and password-protected PDFs, but it cannot currently sanitize them.

When encryption is detected, analysis records the condition and stops deeper inspection of that document. Attempting to sanitize it will result in the encrypted file being skipped.

Use an authorized PDF application to prepare an unencrypted working copy before adding it to PDFSanitize again. Once the file is unencrypted, perform a fresh analysis rather than relying on the earlier encrypted-document result.

The finding count is unexpected

The Findings column shows the number of findings recorded during analysis. It does not represent a count of every confidential fact, hidden word, or security issue in the document.

Some findings describe a document-level structure, while others may identify occurrences on particular pages. A PDF with only a few findings can still contain sensitive visible content, and a PDF with many findings may contain ordinary features that are appropriate for its intended use.

Open the Overview and inspect the actual findings before deciding whether the count is significant.

Hidden content is not detected

PDFSanitize’s hidden-text analysis targets specific conditions, including invisible text-rendering modes and text positioned completely outside the visible page boundaries.

Other forms of concealed information may not produce the same findings. Text hidden beneath graphics, information inside images, or unusual document structures may require a different review.

If reducing the original page-level PDF structures is important, Maximum Assurance is available in Pro and Enterprise. Even then, inspect the visible pages and use proper redaction when confidential information must be removed from the displayed content.

When to contact support

If a document consistently fails analysis after file-access and encryption issues have been ruled out, collect the PDFSanitize version, edition, Windows version, and exact error information.

Note whether the failure occurs with one PDF or several, and whether the same file behaves differently when stored locally. If the document contains confidential information, do not attach it to a support request without an appropriate approved transfer procedure.