Error Reference
Every Draftly error code — what it means and exactly how to resolve it.
Site Generation Errors
| Code | Message | Cause | Fix |
|---|---|---|---|
insufficient_credits | Out of credits | Monthly limit reached | Upgrade plan or wait for monthly reset |
prompt_too_vague | Prompt too short | Under 10 words or no real content | Add more specific detail |
server_busy | Server busy, try again | AI provider 503 (Google / Anthropic) | Wait 60 seconds and retry |
model_timeout | Generation timed out | AI took over 5 minutes | Retry; simplify prompt if it recurs |
auth_error | Authentication required | Session expired | Refresh the page and sign in again |
firestore_error | Save failed | Database write error | Check connection; retry |
generation_failed | Generation failed | Unexpected AI error | Retry once; contact support if persistent |
unknown | Unexpected error | Unclassified | Refresh and retry; include Project ID when contacting support |
Credit & Plan Errors
| Error | Cause | Fix |
|---|---|---|
| "Insufficient credits" in chat | Credits ran out mid-session | Upgrade to continue; or wait for monthly reset |
| "Site limit reached" | Hit max sites for plan this month | Wait for reset or upgrade plan |
| "Chat limit reached" | Used all monthly chat edits | Inline editing and code editing remain free |
| "Resolution not available" | 2K/4K requested on Basic/Pro | Premium+ required for 2K/4K |
| "Video unavailable" | Free plan after 1 clip | Upgrade to Basic for unlimited video |
Video & Frame Errors
| Error | Cause | Fix |
|---|---|---|
| Frame extraction skipped — timeout | Video codec issue or slow decode | Site falls back to static parallax; re-generate video to retry |
| Video generation timeout | Veo queue overloaded | Retry with Relaxed quality (more queue capacity) |
| "Video stalled" | Video decode unavailable in browser | Use Chrome; Safari can have decoder limitations |
| Video URL expired | Signed URL expired before extraction | Reopen the project — system re-fetches automatically |
Authentication Errors
| Error | Cause | Fix |
|---|---|---|
| "Authentication required" | JWT expired or missing | Refresh and sign in again |
| "User mismatch" | Token / body UID conflict | Sign out and sign back in |
| Session expired | Firebase session timed out | Sign in again — work is auto-saved |
| "Subscription not active" | Payment failed, grace period ended | Update payment in Settings → Billing |
Publishing Errors
| Error | Cause | Fix |
|---|---|---|
| "Subdomain taken" | Another user owns this slug | Choose a different subdomain |
| "Invalid subdomain" | Contains invalid characters or reserved word | Letters, numbers, hyphens only; avoid reserved words |
| "Publish failed" | Firebase Storage or Cloudflare error | Retry; contact support if persistent |
| Custom domain not resolving | DNS not propagated | Wait up to 48h; verify CNAME is correctly set |
Getting Help
If an error persists after the steps above:
1.Copy your Project ID — visible in the browser URL:
?projectId=proj_XXXXX2.Note the error message and what action triggered it
3.Email support at support@draftly.business with your Project ID and a description
Support typically responds within 24 hours on business days.