Troubleshooting
Authorization
Symptoms: Trello authorization required, actions fail with auth errors.
Fix: Click Reconnect Trello, allow popups, confirm board write access. Re-authorize in Trello → Applications if you revoked access.
Blank modal or iframe errors
Fix: Close and reopen Doc Flow+, hard-refresh the board, or disable/re-enable the Power-Up. Admins: connector URL must be https://<domain>/power-up/index.html over HTTPS.
Upload failures
| Error | Fix |
|---|---|
| No extractable text | Use text-based PDF or .txt — scanned PDFs are not supported |
| File too large | TXT ≤ 2 MB, PDF ≤ 10 MB |
| PDF blocked | Use a text-based PDF (not a scanned image) |
| Monthly upload limit reached | Wait for the monthly reset or delete old uploads |
Usage limit errors
| Symptom | Fix |
|---|---|
| Monthly AI action limit reached | Wait for the monthly reset (shown on Account) |
| Stored document limit reached | Delete old documents or move items to Trash |
| Feature unavailable message | Check Settings → Enabled AI actions — the action may be turned off for your board |
Missing AI actions
Enable them under Settings → Enabled AI actions (full settings page) and save. Reopen AI Review.
If an action is disabled in board settings, it stays visible but inactive with a helper message.
AI provider errors
End users: contact your admin — API keys are configured server-side.
Self-hosted: set AI_PROVIDER and AI_API_KEY; use mock for local testing.
Could not load documents
Click Try again or Reconnect Trello. Check that the Doc Flow+ backend is reachable.
Safe to ignore (console)
Trello SDK messages, browser extension warnings, and UNSUPPORTED_OS subsystem notices are usually not from Doc Flow+.
More help: Welcome · Privacy policy