--- title: Troubleshooting Guide description: Step-by-step fixes for sign-in, cases, demands, negotiation, trust ledger, and portal problems. ---
Troubleshooting Guide
Fixes ordered from most common to least common. Each section follows the same pattern: symptom → check → fix. For one-line answers, see Common Issues and FAQ and the FAQ.
1. I cannot sign in
- Confirm the email spelling and password, then try again.
- If your firm uses MFA, confirm the code is current (codes expire quickly —
- If the page says the account is inactive, ask an admin to verify the
- Still failing? Clear the field autofill (managers sometimes fill an old
generate a fresh one).
account and resend the invitation if needed.
password) and try once more before contacting support.
2. My invitation link expired or the wizard is stuck
- Invitation links expire — ask a firm admin to send a new one and use the
- If the onboarding wizard seems trapped (for example on a 1-seat trial
newest link in your email.
invite), go back to the dashboard and re-enter onboarding from there, or ask your admin to re-invite you.
3. I cannot see a case
- Search Work → Cases by case number or client name to rule out a filter
- Check with the case owner or an admin: you may not be assigned to the case,
- Leads live in the leads inbox, not the case list — check there before
issue (clear named filters first — invalid filter input is rejected, so a leftover filter can hide results).
or your role may not allow access.
assuming the matter is missing.
4. Room counts look wrong, or a room opened the wrong page
- Refresh first — room lists (
/cases?room=…) match their counts, and IOLTA - Opening a live matter from a room list intentionally lands on the next
- If counts still mismatch after refresh, follow
includes settled matters waiting on a debit, which surprises people.
settlement move, not the overview. Only leads open the overview (to convert to intake).
Stale Version and Browser Cache Refresh.
5. Demand generate or send failed
| Error | Meaning | Fix | |-------|---------|-----| | 409 NO_STORED_MEDICAL | Medical file is empty | Add a treatment, bill, or record on the chronology page, then generate on /cases/:id/demand | | 409 CITED_SEND_REQUIRED | Sibling draft page cannot send | Move to /cases/:id/demand (the cited send path) | | 409 NO_RECIPIENT | No named carrier recipient | Fill in the recipient and send again | | 409 NO_DESTINATION | No destination | Fill in the destination and send again |
Remember: recording delivery marks the letter delivered but does not email, fax, or mail it. If the other side never got the letter, you still need to deliver it through your own channel.
6. I cannot log an offer, or settlement will not unlock
- Enter a dollar amount on every money event — amounts are required, and a
- Log the acceptance with Log acceptance while the matter is negotiable.
- If the room still names Log offer, log the outstanding offer or demand
$0 acceptance can never unlock Settlement.
Changing a status dropdown, dragging kanban, or bulk-editing cannot settle a case — only a logged acceptance owns settlement status.
first.
7. IOLTA debit or reconciliation failed
- Read the ledger banner — it names the exact blocker (open liens, failed
TRUST_OPEN_LIENS: clear open liens in the lien tracker first. Reduced- Overdraw refusal: debits cannot exceed the trust account balance or the
- Bank/book mismatch: the ledger never stamps reconciled on a mismatch.
debit/recon, next step).
medical-bill and subrogation liens still block — clear them too.
client's case balance. Split the entry or correct the amount.
Recheck both balances and reconcile again.
8. A document upload failed
- Confirm the file type is supported (PDF, DOC, DOCX, XLS, XLSX, CSV,
- Refresh the page and retry once.
- If it still fails, contact support with the document type, file size, and
images) and the size fits your plan.
case number. Old revisions are safe at /cases/[caseId]/doc-versions.
9. A signature request went to the wrong email
- Void or cancel the request if possible.
- Correct the recipient email and send a new request — never reuse an
incorrect signing link.
10. An integration says attention or blocked
- Open Settings → Integration Reliability for the exact provider error.
- Reconnect with live credentials, or ask an admin to update them. Stored
409 PROVIDER_NOT_WIREDmeans that provider has no live wiring — it is
stamps alone never count as connected.
not usable yet. Do not retry with the same keys; check the Integration Reliability page for which providers are live.
11. A report export looks short
- Re-run the export — exports stream the complete filtered set in the
- Check your filters: an extra filter narrows the set legitimately.
- Advanced reports stay behind a toggle — enable it first if rows are
current release, so an old short file was likely truncated by the previous behavior.
missing.
12. I see old data after a deployment
- Hard-refresh the page.
- If it persists, follow
- If it still persists, report the page URL and the app version stamp from
Stale Version and Browser Cache Refresh.
Settings/diagnostics to support.
13. Notifications or AI credits look wrong
- Missing notification? Check the notification list and sidebar badges,
- AI credits low? Ask an admin to review usage and add credits. Avoid
including bulk-read state — triaging with mark-all-read hides items by design. Portal messages arrive in the same thread staff answer from Communications Hub.
regenerating the same output repeatedly.
How to report a problem
Include all four: page URL, case number if relevant, what you expected, and what happened (exact error text like TRUST_OPEN_LIENS helps). Send it via the in-app help area or to your firm admin.