> ## Documentation Index
> Fetch the complete documentation index at: https://docs.squarecloud.app/llms.txt
> Use this file to discover all available pages before exploring further.
# Blob Storage
> Scalable serverless storage with global CDN, zero transfer fees, and 99.999999999% availability. Square Cloud Blob Storage is ideal for applications requiring reliable storage.
## Why choose Square Cloud Blob Storage?
As the **largest bot hosting platform in Latin America**, trusted by **80 of the 100 largest Brazilian Discord servers**, we built Blob Storage to solve a problem our own community kept hitting: **Discord's CDN was never meant to be a storage backend**, and links break, expire or get rate-limited. Blob Storage replaces that with an S3-backed object store designed for durability.
The architecture is deliberately simple and robust: an **S3-based object store is the source of truth** for your objects, with a **global CDN** in front for edge delivery. That gives you the **\~11-nines durability** of an S3 design with the read latency of a global cache. Every plan ships **generous included quotas**.
Blob Storage is currently in beta. If you have any feedback, please [contact us](https://squarecloud.app/en/support).
## Key Features
**Zero ingress/egress fees.** Upload and serve as much as you need — you pay for storage, never for bandwidth.
Objects are stored on an **S3-based source of truth** with a design targeting **99.999999999% durability** — no single disk failure loses your data.
Served from **Cloudflare's edge network with edge caching**, so hot assets are delivered close to your users worldwide.
Headroom for **up to 1PB of storage** and **1 billion requests/day** — the same store scales from a hobby project to production traffic.
## Quotas and Pricing
Blob Storage offers clear, transparent pricing so you can choose the plan that fits your needs.
### Included Quotas
Each paid plan includes a **free storage quota** at no extra cost:
| Plan | Free Storage Included |
| ---------- | --------------------- |
| Hobby-1 | **5 GB** |
| Hobby-2 | **15 GB** |
| Standard-4 | **30 GB** |
| Standard-6 | **50 GB** |
| Standard-8 | **100 GB** |
| Pro-12 | **200 GB** |
| Pro-16 | **250 GB** |
| Pro-24 | **250 GB** |
| Enterprise | **250 GB** |
### Reaching your quota
When your usage reaches the included quota, **new uploads are refused** with `STORAGE_QUOTA_EXCEEDED` until you free space or upgrade your plan — everything already stored keeps being served normally. Storage held **above** the quota (for example after a plan downgrade) is priced at:
**R\$ 0.20 per started GiB** beyond your included quota.
[Account Stats](/en/blob-reference/endpoint/stats) reports your current usage and the estimated cost of any storage held beyond the quota.
The Blob Storage service and pay-as-you-go feature are **only available** to subscribers of **paid plans**.
## Supported File Types
Practically **any file type is accepted**, including formats with no registered MIME type: `.bam`, `.vcf`, `.fasta`, `.fastq`, `.parquet`, `.h5`, `.npy` and so on. The stored extension comes from the **filename you upload**, and compound compression suffixes are preserved (`reads.fastq.gz` stays `.fastq.gz`).
The only exception is a denylist of **executables and installers** (`.exe`, `.msi`, `.bat`, `.apk` and similar), refused with `BLOCKED_FILE_TYPE`.
**Serving is safe by design**: the served `Content-Type` is derived server-side, never from the client. Unknown formats and browser-renderable types (`.html`, `.svg`, `.xml`) are always served as **downloads** (`application/octet-stream`), so malicious uploads never render in the browser.
## Performance & Benchmarks
Our infrastructure has undergone **extensive benchmarks** to ensure Square Cloud provides a **robust, reliable serverless storage solution**. Here are some key findings:
* **Latency**: Average file receive latency of **\~11ms**.
* **Throughput**: Average transfer rates of **\~12.5–18.75 MB/s (100–150 Mbps)** on typical connections, reaching **up to \~500 Mbps** on >1–2 Gbps networks.
* **Availability**: Average availability of **99.999999999% (11 nines)** (S3-based design).
In our internal tests in New York, latency remains **negligibly low**, well **below average**.
**Note**: Benchmark results are based on controlled tests and may vary significantly with **geographic location**, **file sizes**, **network quality**, and **peak usage**. For best performance, run tests in your production environment.
**Regional Limitations**: Users in **Africa** and some **Asian regions** may experience higher latencies due to **physical distance from data centers** and **local network infrastructure**.
## How to host your files
Upload your files to the [POST endpoint](/en/blob-reference/endpoint/post). Files over 100 MB, up to **1 GiB**, go through the [chunked upload flow](/en/blob-reference/endpoint/chunked-init).
Access your files using the URL provided in the upload response.
The process is **simplified**: use your account API key for authentication and upload via a **single HTTPS request**. **No additional configuration** or complex infrastructure needed. Square Cloud **handles everything** for you.
## Frequently asked questions
Blob Storage is available to any **paid plan** — Hobby and up — each with its own included storage quota (see the table above). See [Plans and Pricing](/en/platform/plans) for the full comparison.
New uploads are refused with `STORAGE_QUOTA_EXCEEDED` until you delete objects or upgrade your plan — everything already stored keeps being served normally. Storage held above the quota (for example after a downgrade) is priced at **R\$ 0.20 per started GiB**, and [Account Stats](/en/blob-reference/endpoint/stats) shows the estimate at any time.