Discord cloud uploads
discord.food · Storage · 1 record · JSON
Discord cloud uploads (direct-to-GCS, 500 MiB reservation) Storage
caveatemail?card?Rper-object-cap
| Free tier | Reserve an upload slot with POST /channels/{id}/attachments and PUT the body straight into Discord's Google Cloud Storage bucket — the reservation path accepts up to 500 MiB per file, independent of the 20 MiB message-time limit. Note the file still hits the per-message limit when you actually send it, so 500 MiB only helps if the channel/boost tier allows it.unit mixed; metered on stored-bytes |
|---|---|
| Price | none stated |
| Per-object cap | 500 MiB per file (524288000 bytes) |
| Retention | not stated |
| Egress | Free, unmetered, served from cdn.discordapp.com. |
| Identity | email (placeholder) not published |
| Limits |
1-10 files per reservation call; is_clip flag grants a 100 MiB default; requires same permissions as normal attach; DELETE /attachments/{upload_filename} to clean up unused reservations. |
| Binding | per-object-cap the per-object cap sets the shard size and therefore the object count; it bounds the total more tightly than any headline quota |
| Interface | rest rest |
| Tooling | Documented unofficial-API reference (docs.discord.food, formerly 'userdoccers'); Python pseudocode in the page; used in production by large bots. No dedicated library needed — two HTTP calls. |
| Composes with | Upload slots are per-channel, so the 500 MiB ceiling multiplies by channel count (500/server) rather than by account. |
| Reliability | Endpoints are undocumented-but-stable and have moved URL shape before; a reservation you do not consume needs explicit deletion or it lingers. |
| Notes | Reserve an upload slot with POST /channels/{id}/attachments and PUT the body straight into Discord's Google Cloud Storage bucket — the reservation path accepts up to 500 MiB per file, independent of the 20 MiB message-time limit. Note the file still hits the per-message limit when you actually send it, so 500 MiB only helps if the channel/boost tier allows it. |
| Evidence rung | reported One page read moves it to documented. |
| Checked | 2026-10-21 (inherited); stale on 2026-11-04 |
| Parsed numbers |
|
Evidence (2)
| date | source | what it proved |
|---|---|---|
| 2026-10-21 | docs.discord.food/topics/cloud-uploads | 'This allows you to upload up a file up to 500 MiB directly to Google Cloud. Note that file size limits will still apply when sending the attachment in a message.' |
| 2026-10-21 | docs.discord.food/topics/cloud-uploads | 'When uploading a clip, an increased default file size limit of 100 MiB applies.' |
More fields (1)
{
"unit_note": "free_tier.unit is 'mixed' because the headline is denominated in MiB or KiB, which the schema enum does not carry; the verbatim free_tier.stated keeps the true unit. See the storage-dossier handover."
}Unknown or withheld values (6)
$.free_tier.notesprocess$.identity_cost.detaildefaulted$.identity_cost.kindidentity-defaulted$.per_object_cap.notesnot-extracted$.retention.notesnot-extracted$.retention.statednot-extracted