Troubleshoot Document Management and AI results
Find the cause of upload, filing, search and access problems, and know what to send support if you need help.
Start with the symptom
| What you see | Go to |
|---|---|
| A file says Failed in Uploads | Upload problems |
| A document is in the wrong folder or has the wrong name | Filing problems |
| A value Droplet read is wrong | Wrong values |
| You can't find a document you uploaded | Can't find a document |
| You can't see Docs, or an option is missing | Access problems |
Upload problems
New Failed files collect in their own collapsible Failed Uploads section, and the Uploads row in the left panel turns blue while files are uploading, red if the batch had failures, and green once everything is filed.
Open Uploads in the left panel and read the message under the file name.
Files that don't make it collect in the Failed Uploads section with the reason, and the Uploads row reports the batch's status by color.
Open Failed Uploads to see every file that didn't make it, and collapse the section once you have worked through it. Dismiss an upload failure after you retry the file. A processing failure stays in the pane after a page reload, because Droplet investigates it, and it clears when the document is re-imported or deleted.
- Didn't upload. Pick it again to retry.
- The page was closed or reloaded while the file was still uploading. Upload the file again.
- Upload failed. Please try again.
- Droplet couldn't accept the file. Try again in a few minutes. If it keeps failing, contact support with the file name and the time.
- The file type or size isn't accepted
- Docs accepts PDFs, JPEG and PNG images and text files up to 20 MB each. Save other formats as PDF, and split very large scans into smaller files.
If a batch leaves documents in Needs Review, the pane shows a notice with the number of documents that need review and a Review Files button that takes you straight to them.
Droplet retries temporary processing problems on its own, so a file may sit in Processing a little longer before it finishes.
Filing problems
- Check the doctype. Open the document and look at its doctype. If it is wrong, change it from the details panel. Picking a doctype extracts the new doctype's fields right away and shows them as unsaved edits, so check the values, then click Save to keep them or Cancel to drop them.
- Check the values the sorting path uses. A wrong vendor or year sends the document to the wrong folder. Correct the value, and check the result.
- Check the doctype itself. If many documents land in the wrong place the same way, the sorting path or a field's box on the sample needs adjusting. See Organize documents with sorting paths and file names.
Wrong values
Droplet reads each document with AI, and AI can misread. Faint or crooked scans, handwriting, unusual layouts and dense tables are the most common causes. Always compare important values, such as amounts, dates and ID numbers, with the page.
- Correct the value in the details panel. See Correct a value.
- If the same field is wrong on many documents, check that field's box on the doctype's sample covers the value and not its label.
- Rescan blurry paper at a higher quality and upload the clearer copy.
Can't find a document
- Check Uploads: it may still be processing, or it may have failed.
- Check Needs Review: it may be waiting for a doctype, a missing value, or a keep or discard decision on a suspected duplicate.
- Check Recently Uploaded, then search for a distinctive value such as an invoice number, with no filters on.
Don't upload the file again until you have checked all three. A second copy lands in Needs Review, where a Duplicates section above Proposed Doctypes lists one document per duplicate group (the newest copy), and the duplicate waits there even if it is already filed until someone acts on it. Open it to see the blue Duplicate Document panel listing every matching document newest first, then use Keep Both or Keep All to mark the group kept, or Discard Selected to delete the copy you picked.
Access problems
- No Docs in the left menu: Document Management isn't turned on for your organization, or your role has no Documents permission.
- Can't upload: your role is missing Create on the Documents permission, which is all an upload requires.
- Can't edit or delete: your role is missing Update or Delete on the Documents permission.
- Can't create or change doctypes: your role is missing the Document Types permission.
- A shared link won't open: the person needs to sign in to your organization and have access to Docs.
Ask your Droplet admin to check the role. Document and doctype actions, including download, share and the duplicate keep or discard actions, check your current roles in the database, so a role fix takes effect right away without signing out. See Manage access and share document links. If someone can see documents they shouldn't, tell your admin and Droplet support right away.
Questions about AI and your data
For Droplet's current statement on how documents are processed and stored, ask your Droplet account contact or email support@droplet.io before uploading sensitive records.
Contact support
Email support@droplet.io and include:
- Your organization and what you were trying to do.
- The document or file name, or a link to the document.
- The exact message you saw, and roughly when, with your time zone.
- What you have already checked.
Don't attach sensitive documents to your first email. Support will tell you how to send one if it is needed. See Get help with Droplet for more ways to reach us.