Overview

Postnomic tracks media storage usage per blog and enforces limits based on your subscription plan. Understanding how storage is tracked and managed helps you stay within your quota and avoid upload failures.

How Storage Is Tracked

Each blog has a StorageUsedBytes property that records the total size of all uploaded media files. This counter is:

• Updated on upload — When you upload a new file, its size is added to the blog's storage counter
• Updated on deletion — When you delete a file, its size is subtracted from the counter
• Summed across blogs — Your total storage usage is the sum of StorageUsedBytes across all blogs you own

The quota enforcement service (SubscriptionQuotaService) checks your total storage usage before allowing new uploads. If the upload would cause your total usage to exceed your plan's limit, the request is rejected.

Checking Your Storage Usage

From the Dashboard

Navigate to your blog's Settings page to see the current storage usage:

• Used — Total bytes currently consumed by media files on this blog
• Limit — Maximum storage allowed by your plan (summed across all your blogs)
• Percentage — Visual indicator of how much of your quota is consumed

Via the API

Storage information is included in blog detail responses. The StorageUsedBytes field on the blog entity shows the current consumption for that specific blog.

Storage Limits by Plan

These limits apply to the total across all blogs you own, not per individual blog.

What Happens at the Limit

When your total storage usage reaches your plan's limit:

1. Upload attempts fail — The API returns a 403 Forbidden response with a message like: "Storage quota exceeded. Current usage: 1.0 GB, Limit: 1.0 GB."
2. Existing files are unaffected — Your current media continues to work and is served normally
3. Other operations continue — You can still create posts, manage users, and use all non-upload features

Freeing Up Storage

To reclaim storage space:

Delete Unused Media

1. Go to the Media section of your blog dashboard
2. Review uploaded files and identify those no longer in use
3. Delete files that are no longer referenced by any post
4. The StorageUsedBytes counter updates automatically

Review Large Files

Sort media by file size to identify the largest consumers. Consider:

• Replacing unoptimized images with compressed versions
• Converting large PNG files to WebP format
• Removing duplicate uploads

Audit Across Blogs

If you own multiple blogs, check storage usage on each. You may find one blog consuming a disproportionate share of your total quota.

Upgrading for More Space

If you consistently need more storage, upgrade your subscription plan:

1. Navigate to Settings → Subscription
2. Click Upgrade
3. Choose a plan with a higher storage limit
4. Complete the Stripe checkout process
5. Your new storage limit takes effect immediately

Important Notes

• Storage is not recoverable after blog deletion — Deleting a blog permanently removes all its media files
• Downgrading plans does not delete existing files — but you will be unable to upload new files until your usage is within the new plan's limit
• Storage tracking is precise — The system tracks actual byte counts, not approximate file sizes