Troubleshooting: when something goes wrong
What this chapter covers
Documentize is a set of small, focused apps, so most problems are small and local: the wrong file type, a scan where text was expected, a step done in the wrong order, a free-plan limit you hit halfway through. This part collects them in one place. It quotes the messages the site really shows and tells you what each one means, so you can fix it in a minute instead of guessing.
The part is built from two sources: what the app chapters already say in their "Common mistakes & fixes" and "Quality & limits" sections, and what the web page and API actually do when something fails (error text, status prompts, continuations). Where the product text is silent, the book says so rather than inventing a code or promise.
Apps in this chapter
This chapter has no apps of its own. These pages are the entry points:
| Page | Use it when |
|---|---|
| Diagnosis flowchart | You see something odd and do not know where to look. 30 symptoms, each pointing to a page |
| Upload and file problems | Files are rejected, too big, too many, empty, or the server errors out |
| "The result looks wrong" | You have a result, but text, bookmarks, forms, fonts or orientation are off |
| "It stopped half way" | Time limit, page limit, daily allowance, stalled tasks, and the continuation flow |
| Signatures, passwords and permissions | Unlock, Protector, Sign or Verify misbehaves, or you expected a feature that does not exist |
| OCR and AI quality | Scans read badly, or AI answers cannot be trusted |
| Getting help | You need to report a problem; what to include and where |
How to read it
- Start with the symptom, not the app. Open the flowchart, find the line that looks like yours, follow the link.
- Keep three habits that prevent most trouble: keep your original; follow the order repair, orient, OCR, edit, compress, protect, sign (ordering rules); and read the exact message before you retry.
- Know the lifetimes. Results are kept about two days. A free-plan continuation is kept two days, after a default 12-hour cooldown, and costs no extra operation. The daily allowance depends on your plan.
- Know what does not exist. There is no PDF Redactor and no Compare PDFs app; Protector sets one password and nothing else; Sign needs a
.pfxcertificate. Details in security-problems.md. - When unsure, report well. support.md tells you what to gather.
For background, see Limits, plans and the daily allowance, Quality model, and the FAQ.
Ten fixes that solve most problems
- Scan? If you cannot select text, run Searchable before any text or AI app.
- Sideways? Rotation before OCR.
- Wrong language? Set the document language in every OCR step.
- Locked? Unlock before merging, converting, validating or re-protecting.
- Damaged? Recovery, then re-run the app.
- Too big? Splitter or Compressor, or upload by link where the page allows it.
- Stopped by a limit? Download the partial result, then return to the same page in the same browser (stopped.md).
- Bookmarks gone? Rebuild them last (TOC AI).
- Signature broken? Edit the unsigned version and sign again, last.
- AI answer odd? Open the citation and check against the page (trust).