# Processing Failures

Source: https://www.digiparser.com/docs/guides/troubleshooting/processing-failures

Common Problems

# Processing Failures

What to do when document processing fails

Copy MarkdownOpen

# [Processing Failures](#processing-failures)

Feedback

Sometimes document processing can **fail**. This page explains what causes failures and how to fix them.

## [How to identify failed documents](#how-to-identify-failed-documents)

Feedback

1.  Go to your **Document Inbox**.
2.  Use the **status filter** and select **Failed**.
3.  Failed documents will show with **Failed** status.

app.digiparser.com![Document list with Failed status filter](https://documents.digiparser.com/docs/screenshots/2026-07-23/document-list-filters-empty-clean.png?sig=d3307c39df9e8090d0ba3607d6ecb373063b06c52f9a4e7fcd2183483c63dbb5)

## [Common causes of failures](#common-causes-of-failures)

### [Low credits](#1-low-credits)

**Problem**: Not enough credits to process the document.

**Solution**:

*   Open the team menu, click **Billing**, and add credits
*   Re-process the document after adding credits

See [Credits and Billing](/docs/guides/troubleshooting/credits-and-billing) for more details.

### [File format issues](#2-file-format-issues)

**Problem**: The file format is not supported or corrupted.

**Solution**:

*   Check that the file is one of the supported types (PDF, images, Office, text)
*   Try re-saving or re-exporting the file
*   Upload a different version of the file

### [Password-protected PDF](#3-password-protected-pdf)

**Problem**: The PDF requires a password before DigiParser can read it.

**Solution**:

*   Add a PDF password rule in **Settings -> Parser Settings -> Document Processing**
*   Return to the failed document and click **Retry processing**

See [Password-protected PDFs](/docs/guides/parsers/parser-settings/password-protected-pdfs) for setup steps.

### [Processing timeout](#4-processing-timeout)

**Problem**: The document took too long to process (rare).

**Solution**:

*   Try **re-processing** the document
*   If it keeps failing, the document might be too complex or corrupted

### [Upload failure](#5-upload-failure)

**Problem**: The file didn't upload correctly.

**Solution**:

*   Check your internet connection
*   Try uploading again
*   Check file size and count (up to 100 MB per file and 500 files per app-upload batch)

## [What to do when a document fails](#what-to-do-when-a-document-fails)

### [Check the error message](#1-check-the-error-message)

Open the failed document and look for an **error message** in the document view or metadata. This tells you what went wrong.

### [Fix the issue](#2-fix-the-issue)

*   **Low credits**: Add credits and re-process

*   **File issue**: Try a different file or re-save it
*   **Password-protected PDF**: Add a PDF password rule and retry processing
*   **Upload issue**: Try uploading again

### [Re-process the document](#3-re-process-the-document)

After fixing the issue:

1.  Open the failed document.
2.  Click **More (⋮) -> Re-process document**.
3.  The document will be processed again.

## [Preventing failures](#preventing-failures)

Feedback

*   **Check credits**: Make sure you have enough credits before uploading
*   **Use supported formats**: Stick to PDF, images, Office, or text files
*   **Check file quality**: Use clear, readable files and add password rules for password-protected PDFs
*   **Reasonable file sizes**: Very large files (hundreds of pages) may take longer or timeout

## [Tips](#tips)

Feedback

*   **Re-process first**: Often, simply re-processing fixes temporary issues
*   **Check file format**: Make sure files are in supported formats
*   **Monitor credits**: Keep an eye on your credit balance
*   **Contact support**: If a document keeps failing and you can't figure out why, contact support with the document name and error message

## [Next steps](#next-steps)

Feedback

*   [Supported Files and Processing Limits](/docs/guides/document-processing/supported-files-and-limits) - Check supported formats and limits
*   [Understand Document Statuses](/docs/guides/managing-data/document-statuses) - Understand Failed, Skipped, Queued, and Processing
*   [Reprocess Documents](/docs/guides/managing-data/reprocessing-documents) - Run extraction again after fixing the cause
*   [Credits and Billing](/docs/guides/troubleshooting/credits-and-billing) - Understand credits
*   [Password-protected PDFs](/docs/guides/parsers/parser-settings/password-protected-pdfs) - Add rules for encrypted PDFs
*   [Extraction Accuracy Issues](/docs/guides/troubleshooting/extraction-accuracy-issues) - Fix extraction problems
*   [Editing Extracted Data](/docs/guides/managing-data/editing-extracted-data) - Review and edit documents

How is this guide?

GoodBad

[

Manage Billing and Credits

Check credits, change plans, manage payment details, and buy extra page credits

](/docs/guides/advanced-features/billing-and-credits)[

Troubleshoot Email Imports

Find out why an emailed document did not appear or process correctly

](/docs/guides/troubleshooting/email-import-problems)