fshy

Home / Storage

itch.io (butler / Wharf)

itch.io/docs/butler/pushing.htmlPaaSstorage/itch-ioJSONcomparereport an errorprovider JSON

Free allowance
30 GB uncompressed per build ('the itch.io backend will reject builds with a total uncompressed size that exceeds 30GB').
Verdict
caveatusable, with a named limit or an unprobed read path
Cost
free tier
Identity
institution?placeholder, not evidence; card unknown, phone unknown
Binding limit
per-object-capper-object-cap: 30 GB
Evidence
reported5 sources; a third party said so
Freshness
stale on 2026-11-05checked 2026-10-21 (inherited); stale on 2026-11-05
Free tier30 GB uncompressed per build ('the itch.io backend will reject builds with a total uncompressed size that exceeds 30GB'). No documented total-account storage cap; project pages have a soft limit of 20, raisable on request. Free to host, unlimited downloads.
unit GB; metered on stored-bytes
Pricenone stated
Limits
  • per-object-cap (binding) per-object-cap: 30 GB source
per-object-cap: 30 GB uncompressed per build/channel; per-object-cap on HTML5 embeds: 500 MB total extracted and 200 MB per single extracted file; web uploader caps at 2 GB (500 MB default) but butler has no such limit; request-rate not a practical constraint. Retention: builds persist until deleted; no TTL.
Identityinstitution (inferred, not read) not published
EgressFree and unmetered — 'There is no limit to downloads' (itch.io support reply). Files served from itch.zone CDN.
Per-object capper-object-cap: 30 GB (30000000000 bytes)
Retentionper-object-cap: 30 GB uncompressed per build/channel; per-object-cap on HTML5 embeds: 500 MB total extracted and 200 MB per single extracted file; web uploader caps at 2 GB (500 MB default) but butler has no such limit; request-rate not a practical constraint. Retention: builds persist until deleted; no TTL.
Interfacerest, rsync, cli rest
Toolingbutler CLI (butler push / butler download / butler status) plus the Wharf HTTP API — GET https://api.itch.io/wharf/latest?target=user/game&channel_name=X returns the build manifest. butler does rsync-style block diffing so re-pushes are cheap.
Composes with30 GB per build x unlimited channels per project (channel name is arbitrary: windows, osx, bonus, dlc-1, shard-01...) x up to 20+ projects per free account. 1 project x 20 channels = 600 GB on one free account. Each build is independently addressable and downloadable.
ReliabilityPushing the same directory twice is a no-op, so versions accumulate as distinct builds rather than overwriting; butler auth uses an API key, and a project can be taken down by moderation (technical effect: URL 404s, data gone).
Parsed numbers
  • has-free-tier 1
  • per-object-cap 30 GB
Evidence 5
datesourcewhat it proved
2026-10-21itch.io/docs/butler/pushing.html'Limits: currently, the itch.io backend will reject builds with a total uncompressed size that exceeds 30GB.'
2026-10-21itch.io/t/46291/uploading-large-games-faq'butler is a more advanced uploader and has no such technical limits'; web uploader 2 GB ceiling
2026-10-21itch.io/t/6077449/more-project-space'There is no limit to downloads'; butler raises per-project limit to 2 GB instantly, further on request
2026-10-21api.itch.io/wharf/latest?target=test/test&channel_name=windoprobe: GET -> 200 {"errors":["invalid game"]} — endpoint is live and validating, i.e. the manifest read path is public
2026-10-21img.itch.zone/aW1nLzE2ODI3NDY4LnBuZw==/original/ljN55Y.pngprobe: GET -> 200, 39871 bytes, image/png — itch.zone CDN serves originals anonymously, no referer chain
Unknown values 2
  • per object cap notes: the field may be stated in a source that was not read
  • retention notes: the field may be stated in a source that was not read