DocuClipper logo
Troubleshooting

Upload Problems and Errors

Fix the errors DocuClipper shows when a file won't upload - password-protected PDFs, files that aren't valid PDFs, oversized scans - and what to do when an upload seems stuck.

Last updated

If a file won't upload, DocuClipper almost always tells you why in the error message. Match the message below to find the fix. The most common cause by far is a password-protected PDF, which takes about thirty seconds to fix.

For getting the best accuracy out of a file that uploads fine, see Preparing your files for the best results instead.

"Password required" on a bank statement

Many banks email statements locked with a password (often your date of birth or the last digits of your account). On the Convert bank statements page, a locked PDF stays in your list of uploaded files with its name and a Password required box under it. Type the statement's password and click Upload: DocuClipper checks it, uploads the file, and converts it like any other statement. Files that are already unlocked upload as usual next to it.

Uploaded files list on the Convert bank statements page: capitec-april-2026.pdf marked Uploaded, chase-statement-locked.pdf with a Password required box and an Upload button under it, and march-statement-broken.pdf marked Failed with the message This file is not a valid PDF

"Password-protected PDFs are not supported"

Invoice, receipt, and tax form uploads can't open an encrypted file, so remove the protection first and upload the unlocked copy.

On a Mac: open the PDF in Preview and enter the password, choose File → Print, then PDF → Save as PDF in the bottom-left, and save under a new name. The new file has no password.

On Windows: open the PDF in your browser (Chrome or Edge) and enter the password, press Ctrl + P, choose Save as PDF as the destination, and save under a new name.

In Adobe Acrobat: open the file, go to All tools → Protect a PDF → Remove security, then save.

Upload the new, unlocked file. Deleting the password from your bank's download settings, where that's offered, saves you doing this every month.

"This file is not a valid PDF. Please upload a PDF file."

The file isn't a PDF, even if the name ends in .pdf. This usually means one of:

  • It's really an image or a web page that was renamed. Open it - whatever opens it is its actual format.
  • The download was interrupted, leaving a truncated file. Download it again from your bank and check the size looks right.
  • It's a .csv or .xlsx being uploaded to the statement converter. Those go through the bank transactions CSV converter instead.

DocuClipper also accepts JPG, PNG, and TIFF images directly, so if you have a scan in one of those formats, upload it as-is rather than renaming it to .pdf.

"The PDF is too big, try scanning at a lower resolution."

The file's pages are too heavy to process - this is about resolution, not page count. It comes from scans made at very high DPI, where a handful of pages can run to hundreds of megabytes.

Re-scan at around 300 DPI, which is plenty for accurate extraction, or re-save the PDF with your PDF tool's "reduce file size" / "optimize" option. If the file came from a scanner's default setting, dropping from 1200 DPI to 300 DPI typically shrinks it by more than 90% with no loss of accuracy.

"Corrupt JPG, exceeded buffer limits"

Full-resolution phone photos of any size upload normally, so this message means the file itself is damaged, usually from an interrupted transfer off the phone. Open it on your computer to confirm, then copy it again or take a new photo.

Convert can't be clicked

When Convert is greyed out on an upload page, the reason is written just under the button (and shown again when you point at it). Do what it says and the button turns on:

Under the Convert buttonWhat to do
Wait for the upload to finish.Leave the page open until every file shows as uploaded.
Enter the password for the protected PDF above.Type the statement's password in the Password required box. See "Password required".
A file above didn't upload. Remove it or upload it again.Delete the failed file with the trash icon, or upload it again.
"file.pdf" has 675 pages, and a template converts files of up to 250.Switch to automatic conversion, which converts long files in parts, or split the PDF into files of 250 pages or fewer. See Page and file limits.
This upload has 10,001 pages. Up to 10,000 pages convert at a time.Remove some files, convert, then convert the rest.
Up to 100 files convert at a time.Remove the extra files and convert them next.
Choose a template above. / You have no templates yet.Pick a template, create one, or use automatic conversion, which needs no template. See Creating and using custom templates.
These files were already converted.Open the earlier results, or choose Convert anyway.

Page and file limits

You can upload a PDF of any length. DocuClipper converts a file in parts of up to 250 pages, and splits it for you:

  • Long files convert in parts. A 675-page PDF becomes three parts, listed in your project in page order and named after the file with their pages, for example statements (part 2 of 3, pages 244-486).pdf. When a new statement or invoice starts shortly before page 250, the part ends just before it, so a statement is not cut in two. The upload page says this under Convert before you start.
  • An invoice that runs across two parts stays one invoice. When both parts are in the same conversion, it is listed under the part where it starts, with all of its line items and its totals, and the next part starts with the invoice after it. If a part holds only pages from that invoice, selecting it tells you which invoice it continues, with an Open invoice button that takes you there.
  • Big uploads run as several conversions. An upload with more pages than one conversion takes (500 pages, or 250 scanned pages) runs as a few conversions, one after the other, in the same project, each named after the pages it converts, for example statements (pages 1-500) and statements (pages 501-675). The top of each results page says Conversion 1 of 2, links to the others and shows where each one stands.
  • Scanned files are measured once the conversion starts, so the upload page cannot say in advance that a scan will be split; the results page shows the parts as soon as it is.
  • If a part fails, the other parts are still converted and ready. The email you get when the upload is done names the part that failed and links to it: open it and click Convert again next to that part at the top of the page. The retry is charged like any conversion, so the whole file still costs its pages once.
  • Every page costs the same whether or not its file was split, and your pages are spent on the first pages of the file first. If you run out of pages part-way, the remaining parts wait for pages like any other upload, and paying from any part's results page converts all of them.

The Convert bank statements page with statements-2020-2026.pdf uploaded: This job will convert 675 pages, and under the Convert button the note says the file has 675 pages, so it converts in parts of up to 250 pages, each part listed in order as its own file

The results page of AR GL 2025-2026 (pages 1-500): a box at the top reads Conversion 1 of 2, says AR GL 2025-2026.pdf has 675 pages so it is converted in 3 parts as 2 conversions, and lists Pages 1-500 (this one): done and a link to Pages 501-675: done. The document picker below shows AR GL 2025-2026 (part 1 of 3, pages 1-250).pdf

The invoice results of harbor-packet, converted in 2 parts, with part 2 of 2 (page 5) selected in the Document picker and no Invoice picker beside it: a blue note reads This part continues invoice #610102 from part 1. You'll find the full invoice there, with all its line items, above an Open invoice #610102 button

One upload takes up to 10,000 pages and 100 files. Converting with a saved template is the exception: a template's fields are tied to page numbers, so with a template a file can have up to 250 pages. Use automatic conversion for longer files, or split the PDF with the Extract pages tool in Adobe Acrobat, Preview on a Mac, or any free PDF splitter.

The upload seems stuck

An upload that hasn't finished after a few minutes is usually one of these:

  1. A very large file on a slow connection. A few hundred megabytes over a weak uplink genuinely takes a while. Leave the tab open - closing it cancels the transfer.
  2. The tab lost focus or the network dropped. Refresh the page and check the project: if the document is listed, the upload finished and you can carry on.
  3. A large batch. Uploading many statements at once is fine, but progress only shows per file. Upload in smaller batches if you want clearer feedback.

If a file is still not through after roughly fifteen minutes, refresh, delete any half-uploaded copy from the project, and try that one file on its own. If it fails again, email support@docuclipper.com with the file name and the project - we can see what happened to it on our side.

The file uploaded but no transactions came out

That's a different problem - the upload worked and the extraction didn't. See Missing or wrong transactions and Preparing your files for the best results.

FAQs

Can I upload a password-protected statement?

Yes, for bank and credit card statements: enter the password in the Password required box that appears under the file on the upload page. For invoices, receipts, and tax forms, save an unlocked copy - the print-to-PDF trick above is the quickest way - and upload that.

What file types can I upload?

PDF, JPG, PNG, and TIFF for statements, invoices, receipts, and checks. CSV and Excel files go through the bank transactions converter. See Preparing your files for the best results.

Is there a limit on file size or page count?

One upload takes up to 10,000 pages and 100 files. A longer PDF needs no splitting: DocuClipper converts it in parts of up to 250 pages for you (with a saved template, a file can have up to 250 pages). See Page and file limits. For file size, the limit you're likely to hit is scan resolution, which is what the "PDF is too big" message is about.

Why is the Convert button greyed out?

Something still needs doing before the files can convert, and the text under the button says what. See Convert can't be clicked.

My file says it's a PDF but DocuClipper rejects it. Why?

The extension can be wrong. A renamed image or an interrupted download both produce a file that looks like a PDF but isn't. Re-download it from your bank and try again.

Does closing the browser tab cancel my upload?

Yes. The transfer happens from your browser, so keep the tab open until it completes.

Can I upload a scan I made with my phone?

Yes, but a flatbed scan is markedly more accurate. If a phone photo is all you have, shoot the full page square-on in good light, without cropping the balance column on the right.