Smol for newsletter writers

Substack Image Size and File Size Limits, and How to Fit Them

Every newsletter platform sets its own image rules: 5 MB at beehiiv, plan-based caps at Ghost, pixel minimums at Substack. Smol resizes and compresses your images, converts HEIC and PNG to light JPG, WebP or AVIF, and strips location data, all on your Mac before the editor sees them.
  • Resize a folder of images to one width, then set quality
  • Compress phone HEIC and screenshots to light JPG before uploading
  • Images are stripped of GPS and camera metadata by default
  • Shrink PDF lead magnets with a preset before linking them

$29 once per Mac · No subscription · Files never leave your Mac

Smol’s main window in dark and light appearance with an image, a PDF and a video queued and a Compress 3 Files button
By the Smol team9 min read

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 a newsletter writer sends, the limit it runs into, and the Smol setting
What you are sendingThe limit you hitThe Smol setting
Logo and wordmark for a SubstackLogo at least 256 × 256 px, square; wordmark at least 1344 × 256 pxResize to the pixel size, output PNG or JPG
Photos and screenshots inside a post5 MB per image at beehiiv; Ghost(Pro) caps by planCompress, output JPG or WebP, quality 75, maximum dimension about 1600
A post with many imagesbeehiiv warns that email HTML over 102 KB may be clipped in GmailFewer, smaller images; check the editor warning
Downloadable PDF for subscribers25 MB attachment limit in a personal Gmail accountPDF 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.

Published newsletter image and upload figures, with the page each came from
PlatformWhat it statesSource
SubstackLogo: 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
beehiivKeep 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.

Smol settings by newsletter deliverable
DeliverableFormatQuality or presetMaximum dimension
Photo inside a postJPG or WebP75 (the default; our starting point)1600
Hero or header photoJPG80 (our starting point)2000
iPhone HEIC photoJPG, using Compress, not Convert751600
Screenshot with textPNG, or WebP at 80 (check the text)Default1600
Logo or wordmarkPNGDefault; check edgesThe exact pixel size you need, at least 256 or 1344 wide
Image that must hit a size such as 100 KBTarget file size mode4 to 4096 KB; a band, slowUnchanged
PDF lead magnetPDFSmall to email, Medium for scansPresets 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.

  1. Collect the issue’s images in one folder

    Smol writes a copy with a _compressed suffix beside each original and, by default, never overwrites it.

  2. Drag the folder into Smol

    Photos, a PDF and a clip can go in together.

  3. Set output, quality and size

    JPG, quality 75, maximum dimension 1600 for body images. Leave fit mode on fit so nothing is cropped.

  4. 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.

Ways to prepare newsletter images
OptionGood atLimit
Upload straight to the editorZero extra stepsYou depend on what the platform does; Ghost resizes post images, beehiiv suggests resizing yourself
Preview: Tools, Adjust SizeFree, built in, one image at a timeSlow for a folder; no batch quality control
sips in TerminalFree and fast: 24 small images take under a secondCommand line; no quality preview. See the sips guide
Online compressors such as TinyPNGEasy, no installFiles go to a server; usage caps may apply
SmolBatch resize, quality, HEIC to JPG, strip GPS, locallyMac 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