Document Vault troubleshooting
Resident: "I don't see any documents"
| Check | Action |
|---|---|
| Flat not claimed | Complete flat claim first |
| Nothing published yet | Ask the committee to upload and publish with members visibility |
| Wrong visibility | Admins must set visibility to members and turn publish on |
| admins_only file | Treasurer drafts and internal contracts stay admin-only by design |
Resident: download failed or link expired
Signed URLs last 120 seconds. Tap Download again for a new link. Use a stable connection; very large files (near the 25 MB limit) may need to finish within the window.
Admin: upload rejected
| Error | Fix |
|---|---|
| File too large | Compress or split; max 25 MB per file |
| Unsupported type | Use PDF, JPEG, PNG, WebP, Word (.docx), or Excel (.xlsx) |
| Not authorized | Confirm you are a society admin for this society |
| Storage error | Retry; check network; contact support if persistent |
Admin: residents still cannot see a published document
- Open Admin → Documents and confirm:
- Published is on
- Visibility is members (not admins_only)
- Ask the resident to refresh Documents (
/documents). - Confirm the resident has a claimed flat in this society.
Admin: changed visibility but unsure if it applied
Every publish/visibility change calls set_document_visibility and writes to the audit_log.
Check society audit records for document.visibility actions.
Admin: wrong file uploaded
- Unpublish the incorrect document (or delete it).
- Upload the correct file with an updated title.
- Publish when ready.
- Post a notice if members may have saved the wrong version.
Document Vault vs poll credentials
Voters uploading credential documents for a specific poll follow a different flow. Society-wide records belong in Document Vault.
See also: FAQ · Admin guide.