methodology
Video Download Failure Reason Taxonomy
A standard failure vocabulary for download pages, queues, API responses, and support docs.
A useful failure taxonomy tells the user whether the problem is permissions, availability, platform change, unsupported format, queue limits, or a safety refusal. It should not collapse every issue into a generic failed message.
Direct answer
A useful failure taxonomy tells the user whether the problem is permissions, availability, platform change, unsupported format, queue limits, or a safety refusal. It should not collapse every issue into a generic failed message.
Method
- Classify access failures such as private, deleted, login-only, paid, or region-limited content.
- Classify technical failures such as unsupported media format, expired manifest, missing segments, or platform response changes.
- Classify product limits such as file size, free queue, rate limit, or API approval status.
- Classify safety refusals such as DRM, paywall, private content, or creator-rights risk.
Fields to record
- Failure code
- User message
- Recommended next step
- Retryable
- Safety category
- Support note