How Do I Optimize My Images for HubSpot? A Complete Guide to Boosting Page Speed and SEO
Why Image Optimization Matters in HubSpot (and What Happens If You Skip It)
If you’ve ever clicked on a blog post that took eight seconds to load, you already know why image optimization is not a “nice-to-have” — it’s a ranking factor and a user-experience killer. HubSpot’s CMS gives you a fantastic Content Delivery Network (CDN) and automatic image compression, but the platform won’t magically fix everything for you. The truth is, HubSpot has specific file size limits (up to 25 MB per image in the File Manager), but that doesn’t mean you should upload a 10 MB hero image. The bigger the file, the slower your page, the higher your bounce rate, and the worse your Google Core Web Vitals scores.
But here’s the thing: optimizing images for HubSpot isn't just about clicking “compress” and calling it a day. It involves a strategic workflow — from choosing the right format (WebP vs. PNG vs. JPEG) to leveraging HubSpot’s built-in hs-srcset parameters and ensuring your alt texts are meaningful. Let me walk you through the exact process I use for my clients, and by the end, you’ll know exactly how to optimize your images for HubSpot without losing quality.
Step 1: Choose the Right File Format Before Uploading
This is the single most overlooked step. HubSpot supports PNG, JPEG, GIF, SVG, WebP, and AVIF. But not all formats are created equal:
- JPEG (JPG): Best for photographs and complex images. Smaller file size but loses transparency.
- PNG: Best for logos, graphics with text, and images needing transparency. But PNG files are heavy. A 1200px wide PNG can easily hit 2–3 MB.
- WebP: This is the modern winner. It combines lossless and lossy compression, giving you 25–35% smaller files than JPEG/PNG with the same visual quality. HubSpot automatically converts some images to WebP when you use their
hs-webpparameter, but you can also upload WebP directly. - SVG: Only for vector graphics like icons. Never use SVG for photos — the file size will balloon.
My rule of thumb: For any hero image or blog featured image, upload a WebP (or high-quality JPEG if WebP isn’t available in your editing tool). For logos, stick to PNG unless the logo is simple — then use SVG.
Step 2: Resize Your Images to the Exact Dimensions HubSpot Needs
This is where most people fail. They upload a 3000px-wide image because “it looks sharp on desktop.” But HubSpot’s CMS will generate multiple sizes (200px, 360px, 720px, 1250px, 2048px) for responsive loading. However, if your original is 3000px, HubSpot still has to scale it down, and that creates extra server work and a larger original file stored in your File Manager.
What I do:
- For blog featured images: Resize to 1600px wide at 72 DPI (screen resolution).
- For in-content images (Infographics, screenshots): Resize to 800–1200px wide.
- For product photos on landing pages: Resize to 1000px wide on the longest side.
Why 1600px? Because most blog themes have a max content width of 800–1000px, but a 1600px source ensures that HubSpot’s retina (2x) version looks crisp. Don't go beyond 2000px – you’re just wasting storage and slowing your admin.
Step 3: Rename Your File Before Uploading (Keyword in Filename)
I can’t tell you how many files I see in HubSpot named IMG_4382.jpg or Screenshot 2024-01-01 at 10.32.45 AM.png. That is a missed SEO opportunity. When you upload an image to HubSpot, the file name becomes part of the image URL path — and Google reads that path.
Best practice: Use hyphens (not underscores) to separate words. Include your primary keyword naturally.
- ❌ Bad:
DSC_0042.jpg - ✅ Good:
hubspot-image-optimization-guide.jpg
Remember: HubSpot will keep this URL for the life of the image. If you rename it later, the old URL breaks (unless you set up a redirect). So rename your file BEFORE you upload.
Step 4: Fill In the Alt Text and Title Text Like a Human
HubSpot has two fields in the File Manager: Alt Text and Title Text. Do not confuse them.
- Alt Text: This is for accessibility and image SEO. It tells screen readers and search engines what the image is about. Write it descriptively and naturally, including your target keyword once if it fits.
- ❌ Bad:
image - ✅ Good:
HubSpot image optimization dashboard showing compression settingsText**: This is the tooltip that appears when someone hovers over the image. It’s less important for SEO, but it still helps user experience. I usually add a short call-to-action like “Click to enlarge” or just repeat the alt text with a slight variation.
- ❌ Bad:
Pro tip: Do not stuff your keyword into every image’s alt text. That looks spammy to Google. Use it only on your primary image (hero or featured).
Step 5: Use HubSpot’s Built-in Image Compression (But Don’t Rely on It Alone)
HubSpot’s CDN automatically compresses images using Smart Compression (which uses lossy compression on images larger than 200KB). This is a lifeline, but it has a side effect: over-compression can create visible artifacts like banding or blurriness on gradients.
Here’s my workflow to avoid that:
- Before uploading, I compress the image myself using a tool like Squoosh.app (free, no install) or ImageOptim (Mac).
- I set the quality to 70–80%. That’s the sweet spot for web: still looks great, but file size drops dramatically.
- I upload the compressed version to HubSpot. Then HubSpot’s Smart Compression kicks in, but since my file is already small, it doesn’t need to do heavy lifting.
Result? My images are usually under 150KB for a 1600px-wide image. That’s a night-and-day difference from the default 2MB uploads.
Step 6: Take Advantage of HubSpot’s hs-srcset for Responsive Images
When you upload an image directly into a rich text module or blog post in HubSpot, it automatically adds srcset attributes. But if you insert images via a custom module that only references a single URL, you’re losing that.
How to check: Right-click an image on your page and click “Inspect”. If you see <img src="..." srcset="...", then HubSpot is already generating multiple sizes. If you only see a single src, then you need to enable the responsive image resizing feature in your HubSpot theme (usually in the template code: {{ resize_image_url(image_url, 0, 720) }}).
If you’re not comfortable editing code, the easiest path is to use the standard HubSpot drag-and-drop editor for all your images, not a custom HTML module. The drag-and-drop editor automatically applies srcset.
Step 7: Lazy Load Your Images (But Not the Hero)
Lazy loading means images below the fold (the ones the user has to scroll to see) only load when the user scrolls near them. This is a huge page speed win. HubSpot has a theme setting called "Lazy Load Image" – you can enable this for all images by default in your theme options.
But here’s the catch: Do NOT lazy load your hero image or the first image in your blog post. Google’s Largest Contentful Paint (LCP) measures the largest element in the viewport. If your hero is lazy-loaded, LCP shoots up, and your Core Web Vitals get penalized. So lazy load everything except the top image.
Step 8: Leverage HubSpot’s Folder Structure for Image Management
This isn’t a direct SEO ranking factor, but it helps your SEO workflow. In HubSpot File Manager, create folders by post topic or campaign. For every blog post, upload images into a folder named with the post slug. Example: /blog/how-to-optimize-images-hubspot/.
Why does this matter? When you run a site audit, you can easily identify orphan images or duplicate files. Plus, organized folders help multiple content editors avoid re-uploading the same image with different names, which creates duplicate file URLs.
Step 9: Use WebP in Your RSS Feed (For Email Subscribers)
If you have newsletter subscribers reading your blog via RSS, WebP images might not render properly in some older email clients. What I do: Upload a JPEG version for the email excerpt and a WebP version for the full blog post. HubSpot’s email editor will pull the featured image from the post – so make sure your featured image is a JPEG with mobile dimensions (1200x630px works well for social shares). Then, inside the article, use the WebP files.
Step 10: Test Your Page Speed After Every Post
After you publish, run a quick check with Google PageSpeed Insights and look at the waterfall. If I see an image taking more than 2 seconds to load, that’s a red flag. I can then go back, open the image in HubSpot File Manager, and recompress it.
One more thing: Publish the post first, then replace the image if you need to. Don’t delete and re-upload the same image in the same URL unless you want to risk broken screenshots in old content.
Final Checklist for HubSpot Image Optimization
| Task | Status |
|---|---|
| Rename file with keywords (hyphens) | |
| Resize to 1600px max width | |
| Compress to under 150KB | |
| Upload as WebP (or JPEG at 75% quality) | |
| Fill alt text (descriptive, includes primary keyword once) | |
| Fill title text (short, user-friendly) | |
| Enable lazy load (except hero) | |
Verify srcset is active in page inspection |
|
| Check Google PageSpeed Score > 85 |
The Bottom Line
Optimizing images for HubSpot isn’t a one-time action — it’s a habit. Every image you upload should go through the same rigmarole. Once you build this into your workflow, your site will load faster, rank higher in image searches, and give your page visitors a smooth experience. I’ve seen sites drop their average load time from 5.2 seconds to 1.8 seconds just by following this exact system.
If you want to go deeper, check out HubSpot’s official documentation on file types and limits to see their latest storage policies. But honestly, the ten steps above will solve 95% of your image performance issues.
So go ahead — open your HubSpot File Manager right now, pick your heaviest image, and run it through these steps. Your visitors (and Google) will thank you.
