Troubleshooting
Core workflow troubleshooting
Diagnose common import, queue, rights, permission, theme, and session failures.
- 8 min read
- 8 min read
- Last reviewed 2026-08-04
- Last reviewed 2026-08-04
- Intermediate
- Intermediate
Overview
Core workflow troubleshooting starts with the visible symptom and last completed state. Avoid repeated imports or uploads until you know whether the original job persisted data.
Before you begin
Record the route, Workspace, Catalog, filename, job reference, time, and exact message. Never include passwords, secrets, or complete payment credentials.
Where to find it
Use Operations → Processing Queue (/jobs), Spreadsheet Import History, Rights Validation, and the original workflow page.
Step-by-step instructions
- Confirm Workspace, Catalog, role, connection, and whether the action was validation or persistence.
- Locate the original job and wait for success or failure before retrying.
- Apply the matching correction below, retry once, and verify the resulting record.
- Contact support with sanitized evidence if the same failure repeats.
What happens next
A successful retry produces one execution result. Verify tracks, assets, rights status, or cues before another attempt.
Best practices
Keep source files unchanged, download error reports, and use exact identifiers to check for partial success.
Common problems
Spreadsheet upload fails: verify CSV/XLSX and connectivity. Worksheet missing: confirm a readable populated sheet. Column conflict: use Advanced Mapping and ignore redundant aliases. Missing title or blocked validation: correct source values, then validate again. Import failed or tracks missing: inspect Import History, execution result, and Catalog filter. Audio failed or stuck: verify WAV/MP3/AIFF/FLAC, then check Processing Queue. AI suggestions missing: clear filters and confirm eligibility. Rights status persists: verify party, assignment, shares, master, and clearance. Publisher review remains: party verification does not replace assignment verification. Cue Sheet import fails: use RapidCue or generic CSV/XLSX and review parsing errors. Permission denied: confirm membership and role; Platform is SUPER_ADMIN-only. Theme contrast or sidebar state: switch theme once, refresh, and preserve the route in a report. Article missing: unpublished content is excluded from search. Session issue: sign in again and reopen the Workspace.
Troubleshooting
When retry is unavailable, the job may still be active or the role may be read-only. After a repeated failure, stop creating records and contact support with the job reference and expected result.
Related articles
See Frequently asked questions, Resolve column mapping conflicts, and Audio Import overview.