Overview
Postnomic uses Azure Blob Storage to host all media files associated with your blog. Images and other files are uploaded through the dashboard or API and served to readers through a built-in blob proxy that ensures consistent delivery.
Supported Formats
Postnomic supports the following image formats:
| Format | Extension | Best For |
|---|---|---|
| JPEG | .jpg, .jpeg |
Photographs, complex images with gradients |
| PNG | .png |
Screenshots, images with transparency |
| WebP | .webp |
Modern format with excellent compression |
| GIF | .gif |
Simple animations, icons |
| SVG | .svg |
Logos, icons, diagrams (vector graphics) |
Uploading Images
From the Post Editor
When creating or editing a post, you can upload images directly:
- Open the post editor
- Click the image upload button or drag and drop an image onto the editor
- Select the image from your computer
- The image is uploaded to Azure Blob Storage and a reference is inserted into your content
Post Images
Each post supports three dedicated image fields:
- Cover Image — Displayed at the top of the post and in blog listings. Recommended size: 1200x630 pixels.
- Thumbnail Image — Used in compact listing views. A smaller version of the cover image.
- Share Image — Used for Open Graph and social media previews. Recommended size: 1200x630 pixels.
Upload these from the post editor's image section.
From the Media Library
Access the media library from your blog dashboard to:
- Browse all uploaded files
- Upload new files outside of the post editor
- Copy media URLs for use in content
- Delete unused files to free up storage
Storage Limits
Media storage is metered per blog owner and counted across all blogs you own:
| Plan | Storage Limit |
|---|---|
| Free | 100 MB |
| Plus | 1 GB |
| Pro | 10 GB |
| Enterprise | 100 GB |
When you attempt to upload a file that would exceed your storage limit, the API returns a 403 Forbidden response with a message indicating the quota has been reached. Upgrade your plan or delete unused files to free up space.
How the Blob Proxy Works
Postnomic serves media files through the BlobProxyController rather than exposing direct Azure Blob Storage URLs. This provides several benefits:
- Consistent URLs — Media URLs work regardless of the underlying storage configuration
- Access control — Files are served through the API, which can enforce authentication when needed
- Portability — If the storage backend changes, media URLs remain stable
When a Client SDK renders a post with images, it automatically resolves image references through the API's blob proxy endpoint.
Upload Best Practices
- Optimize images before uploading — Compress JPEG and PNG files to reduce storage usage and improve page load times
- Use WebP when possible — WebP provides superior compression compared to JPEG and PNG
- Choose appropriate dimensions — Do not upload 4000-pixel-wide images for a blog that displays at 800 pixels
- Use descriptive filenames — Name files descriptively (e.g.,
docker-architecture-diagram.png) for easier management - Monitor storage usage — Check your storage consumption regularly under blog settings