Recording Processing States

Recording state names should be interpreted with the timeline, storage object state, and processing job history. Do not rely on one status field alone when a customer reports a stuck export.

Uploading

Uploading means source media may still be in transit. Check multipart upload state, object size, browser close timing, and whether upload completion was acknowledged.

Processing

Processing means a worker is creating playback-ready media, thumbnails, clips, captions, or downloadable derivatives. Long recordings can take longer. A processing state with no recent heartbeat or progress event needs worker/job review.

Ready

Ready means normal playback and supported exports should be available. If the customer still cannot export, check entitlement, browser state, stale UI cache, and derivative-specific failure.

Failed

Failed can mean worker timeout, unsupported media, missing source object, storage limit, or processing dependency failure. Retry only after confirming the source object exists and worker health is stable.

Customer-safe wording

Say: “The recording is still being prepared” or “The processing job needs review.” Do not say a worker crashed, a bucket key is missing, or an internal queue failed unless that wording has been approved for the incident.