Substack image size rules come in two kinds: pixel minimums for your logo and wordmark, which Substack publishes, and the weight of the images inside each email, which you control. Here are the published numbers for Substack, beehiiv and Ghost, and the Smol settings that keep a newsletter light.
| What you are sending | The limit you hit | The Smol setting |
|---|---|---|
| Logo and wordmark for a Substack | Logo at least 256 × 256 px, square; wordmark at least 1344 × 256 px | Resize to the pixel size, output PNG or JPG |
| Photos and screenshots inside a post | 5 MB per image at beehiiv; Ghost(Pro) caps by plan | Compress, output JPG or WebP, quality 75, maximum dimension about 1600 |
| A post with many images | beehiiv warns that email HTML over 102 KB may be clipped in Gmail | Fewer, smaller images; check the editor warning |
| Downloadable PDF for subscribers | 25 MB attachment limit in a personal Gmail account | PDF preset Small or Medium |
What is the right Substack image size, and what do beehiiv and Ghost allow?
Substack publishes minimum pixel sizes for its logo and wordmark and no file size limit on that page. beehiiv publishes a 5 MB guideline and a 1200 × 630 thumbnail. Ghost(Pro) sets an upload cap by plan. Each figure below comes from the platform’s own page.
| Platform | What it states | Source |
|---|---|---|
| Substack | Logo: a square image of at least 256 × 256 pixels. Wordmark: at least 1344 × 256 pixels. The cover photo appears on the welcome page. The page lists no file-size limit and no cover dimensions. | Substack FAQ |
| beehiiv | Keep image files under 5 MB, and GIFs under 5 MB. Use JPG for photos, PNG for graphics, GIF for short animations. Recommended thumbnail: 1200 × 630 px. Resize before uploading when possible. | beehiiv help |
| Ghost(Pro) | Media file size limit by plan: Free trial 5 MB, Starter 5 MB, Publisher 100 MB, Business 250 MB, Custom 1 GB. The page says media files and does not name images or cover self-hosted sites. | Ghost help |
| Gmail (readers and you) | Personal accounts: 25 MB of attachments; above that, Gmail adds a Drive link. | Google Help |
Substack’s page gives no size for covers, email banners or post images, so check the upload screen in your own publication settings for the limit it enforces.
What is the best newsletter image size for email?
The pages above give no single width for body images, so this is a starting point, not a rule: export at about 1600 pixels on the long edge. That is enough detail for a retina phone screen, and well below a 12-megapixel camera frame. Wider than the reader’s screen buys nothing.
What is the Ghost image upload limit?
For Ghost(Pro) it depends on your plan: 5 MB on Free trial and Starter, 100 MB on Publisher, 250 MB on Business and 1 GB on Custom. Ghost’s theme documentation adds that it “automatically compresses and resizes images added to your post content”, so a smaller upload still helps your own storage and editor speed.
What is a good email image file size?
Keep each image as small as the picture allows. beehiiv’s ceiling is 5 MB, but its help page also says that large emails may get clipped in Gmail if the HTML goes over 102 KB, and that the editor warns you when a post becomes too large.
That 102 KB figure is about the HTML of the email, not the weight of the pictures, so a compressed photo does not by itself prevent clipping. What helps is fewer images, shorter markup and images that load fast on a phone. A 4 MB photo that only shows at 600 pixels wide is slow for subscribers and wasteful for you. Our starting targets, not platform rules: photos under 300 KB, screenshots under 150 KB, and check the output of every batch.
- Photos: JPG or WebP at quality 75, long edge 1600.
- Screenshots and charts: PNG if text must stay crisp, or compress to WebP.
- Animations: keep GIFs short; beehiiv asks for under 5 MB.
- Remove the GPS from phone photos before they leave your Mac.
For why a smaller image also loads faster, our Core Web Vitals measurements go into detail.
Which Smol settings fit newsletter images?
Use Compress, set the output format, quality and maximum dimension, then check the results. Smol sets quality and pixel size, not output bytes, so it cannot promise a file under a cap.
| Deliverable | Format | Quality or preset | Maximum dimension |
|---|---|---|---|
| Photo inside a post | JPG or WebP | 75 (the default; our starting point) | 1600 |
| Hero or header photo | JPG | 80 (our starting point) | 2000 |
| iPhone HEIC photo | JPG, using Compress, not Convert | 75 | 1600 |
| Screenshot with text | PNG, or WebP at 80 (check the text) | Default | 1600 |
| Logo or wordmark | PNG | Default; check edges | The exact pixel size you need, at least 256 or 1344 wide |
| Image that must hit a size such as 100 KB | Target file size mode | 4 to 4096 KB; a band, slow | Unchanged |
| PDF lead magnet | Small to email, Medium for scans | Presets are pixel caps |
Compress to JPG rather than Convert, because quality applies to Compress. The target file size mode takes about 28 seconds for one 768 × 512 image and lands in a band, so use it only for the few files that miss.
For scale: on 24 small Kodak test photos at default settings, Smol made high-quality JPEGs 69.3% smaller. Those are 768 × 512 film scans, so your camera files will behave differently. See the benchmark page.
How do I prepare newsletter images on a Mac?
Drop the folder into Smol, set JPG at quality 75 and a maximum dimension, run it, then open the largest output. Four steps, about the same every issue.
Collect the issue’s images in one folder
Smol writes a copy with a
_compressedsuffix beside each original and, by default, never overwrites it.Drag the folder into Smol
Photos, a PDF and a clip can go in together.
Set output, quality and size
JPG, quality 75, maximum dimension 1600 for body images. Leave fit mode on fit so nothing is cropped.
Check the biggest file, then upload
Sort by size. If one is still over your platform’s limit, lower quality or the pixel size and run that file again.
Phone photos often carry GPS. Smol strips it by default; see how to strip GPS from photos and open one output to confirm. For iPhone shots in HEIC, read batch converting HEIC to JPG.
What do newsletter writers use today to shrink images?
The platform’s own editor, Preview and online compressors come first, and each has a cost. The table compares them fairly.
| Option | Good at | Limit |
|---|---|---|
| Upload straight to the editor | Zero extra steps | You depend on what the platform does; Ghost resizes post images, beehiiv suggests resizing yourself |
| Preview: Tools, Adjust Size | Free, built in, one image at a time | Slow for a folder; no batch quality control |
| sips in Terminal | Free and fast: 24 small images take under a second | Command line; no quality preview. See the sips guide |
| Online compressors such as TinyPNG | Easy, no install | Files go to a server; usage caps may apply |
| Smol | Batch resize, quality, HEIC to JPG, strip GPS, locally | Mac only, $29 once, slower than sips, and no lossless mode |
Our comparison of Mac image methods lays them out, and the sips guide covers the Terminal route. For a blog behind the newsletter, see blog image optimization or the WordPress image page.
When Smol is the wrong tool
Smol suits batches on a Mac. It is the wrong choice in these cases.
- You write on a phone or a Windows PC: Smol is macOS only.
- You need pixel-identical optimization: Smol always re-encodes, with no lossless mode. ImageOptim is the answer there.
- You need vector art such as SVG: Smol does not handle it.
- You need a few images resized in seconds: sips is faster than Smol for small jobs.
- You want it to guarantee a byte count: Smol sets quality and pixels, so always check the result.
Frequently asked questions
What is the right Substack image size?
Substack states minimums for its identity images: a square logo of at least 256 by 256 pixels and a wordmark of at least 1344 by 256. Its FAQ gives no size for post images or a file-size limit. For body images we suggest about 1600 pixels on the long edge, then check the result in your editor.
What is the best newsletter image size?
The platform pages give no single width for newsletter body images. Our starting point is 1600 pixels on the long edge at JPG quality 75, which stays sharp on retina phones while keeping files light. Hero images can go to 2000. Check the file in your platform’s preview before sending to your list.
What is the beehiiv image size and file limit?
beehiiv’s help page says to keep image files under 5 MB, GIFs too, and recommends a 1200 by 630 pixel thumbnail. It suggests JPG for photos, PNG for graphics and resizing before upload. It also warns that email HTML over 102 KB may be clipped in Gmail.
What is the Ghost image upload limit?
On Ghost(Pro) the media file limit depends on the plan: 5 MB for Free trial and Starter, 100 MB for Publisher, 250 MB for Business and 1 GB for Custom. Ghost’s page does not cover self-hosted sites, where the limit comes from your own setup, so check your hosting.
How big should an email image file size be?
There is no universal cap, but heavy emails load slowly and beehiiv notes Gmail may clip HTML over 102 KB. As a starting point, aim for photos under 300 KB and screenshots under 150 KB, at no wider than the reader’s screen needs. Always open the compressed copy and check it.
Can Smol make an image a specific file size?
Smol has a target file size mode for images, from 4 to 4096 KB. It aims at a band, not a hard ceiling, and takes about 28 seconds for a 768 by 512 image, so a file can land slightly over. For most newsletter images, setting quality and maximum dimension, then checking the output, is quicker.
Keep reading
Smol for other teams
