Guide
- Aspect ratio
- CMS
Guide
- Aspect ratio
- CMS
Guide
- Aspect ratio
- CMS
How to Keep Aspect Ratio of the Uploaded Image in Framer CMS
Ever uploaded an image to your Framer site and it shows up totally cropped or stretched? Yeah, been there. If you’re using Framer CMS to manage your content and want your visuals to always look sharp and properly scaled, you need a way to keep their original aspect ratio intact. I’ve got a hack for you, let’s dive in.



Table of contents
The problem: cropped or stretched images
By default, when you drop a CMS-connected image into your Framer project, it might not respect the original aspect ratio. This means your beautiful landscape photo can end up looking like a weirdly zoomed-in thumbnail—or worse, a squished mess.
The fix: aspect ratio image component
This component automatically detects the aspect ratio of the uploaded image and adjusts the frame accordingly. That means no more guesswork or manual resizing, your image will always keep its proportions, no matter the screen size.
The problem: cropped or stretched images
By default, when you drop a CMS-connected image into your Framer project, it might not respect the original aspect ratio. This means your beautiful landscape photo can end up looking like a weirdly zoomed-in thumbnail—or worse, a squished mess.
The fix: aspect ratio image component
This component automatically detects the aspect ratio of the uploaded image and adjusts the frame accordingly. That means no more guesswork or manual resizing, your image will always keep its proportions, no matter the screen size.
The problem: cropped or stretched images
By default, when you drop a CMS-connected image into your Framer project, it might not respect the original aspect ratio. This means your beautiful landscape photo can end up looking like a weirdly zoomed-in thumbnail—or worse, a squished mess.
The fix: aspect ratio image component
This component automatically detects the aspect ratio of the uploaded image and adjusts the frame accordingly. That means no more guesswork or manual resizing, your image will always keep its proportions, no matter the screen size.

Aspect ratio component.

Aspect ratio component.

Aspect ratio component.
How to use it
Drop in the Aspect Ratio Image component. Upload your image, Head to the component settings and connect your CMS image field to the Image property. Style it your way
Radius — Round the corners for a smoother look.
Border — Add a frame or subtle outline.
Shadows — Give it some depth.
Draggable — Toggle this on if you want the image to be interactive (great for portfolios or playful UI).
How to use it
Drop in the Aspect Ratio Image component. Upload your image, Head to the component settings and connect your CMS image field to the Image property. Style it your way
Radius — Round the corners for a smoother look.
Border — Add a frame or subtle outline.
Shadows — Give it some depth.
Draggable — Toggle this on if you want the image to be interactive (great for portfolios or playful UI).
How to use it
Drop in the Aspect Ratio Image component. Upload your image, Head to the component settings and connect your CMS image field to the Image property. Style it your way
Radius — Round the corners for a smoother look.
Border — Add a frame or subtle outline.
Shadows — Give it some depth.
Draggable — Toggle this on if you want the image to be interactive (great for portfolios or playful UI).

The properties of aspect ratio image component in Framer.

The properties of aspect ratio image component in Framer.

The properties of aspect ratio image component in Framer.
Why it matters
Here’s a quick comparison:
On the left, a standard image element that crops to fill the frame. On the right, the same image using the Aspect Ratio Image Component—it’s fully visible, perfectly proportioned, and much more professional.
This small change can make a huge difference in how polished your site feels.
Perfect for CMS-driven projects
When you’re handing off a site to a client, or even managing your own blog or portfolio, you don’t want to worry about every image being a perfect size. With this component, you’re future-proofing your layout. Just upload and go.
Wrapping up
Cropped images suck — use this component to fix that.
Preserve original proportions with zero extra work.
Fully customizable with borders, shadows, radius, and drag behavior.
CMS-friendly, making it perfect for dynamic content.
Next time you’re uploading an image in Framer, make sure it looks as good as you intended, every time. Drop in the Aspect Ratio Image Component and let it do the heavy lifting.
Why it matters
Here’s a quick comparison:
On the left, a standard image element that crops to fill the frame. On the right, the same image using the Aspect Ratio Image Component—it’s fully visible, perfectly proportioned, and much more professional.
This small change can make a huge difference in how polished your site feels.
Perfect for CMS-driven projects
When you’re handing off a site to a client, or even managing your own blog or portfolio, you don’t want to worry about every image being a perfect size. With this component, you’re future-proofing your layout. Just upload and go.
Wrapping up
Cropped images suck — use this component to fix that.
Preserve original proportions with zero extra work.
Fully customizable with borders, shadows, radius, and drag behavior.
CMS-friendly, making it perfect for dynamic content.
Next time you’re uploading an image in Framer, make sure it looks as good as you intended, every time. Drop in the Aspect Ratio Image Component and let it do the heavy lifting.
Why it matters
Here’s a quick comparison:
On the left, a standard image element that crops to fill the frame. On the right, the same image using the Aspect Ratio Image Component—it’s fully visible, perfectly proportioned, and much more professional.
This small change can make a huge difference in how polished your site feels.
Perfect for CMS-driven projects
When you’re handing off a site to a client, or even managing your own blog or portfolio, you don’t want to worry about every image being a perfect size. With this component, you’re future-proofing your layout. Just upload and go.
Wrapping up
Cropped images suck — use this component to fix that.
Preserve original proportions with zero extra work.
Fully customizable with borders, shadows, radius, and drag behavior.
CMS-friendly, making it perfect for dynamic content.
Next time you’re uploading an image in Framer, make sure it looks as good as you intended, every time. Drop in the Aspect Ratio Image Component and let it do the heavy lifting.