▶️How to crop an image without cropping the original
Crop images visually in Webstudio without modifying the original file.
Learn how to visually crop images in Webstudio without modifying the original image file.
Overview
Sometimes you need an image to fit a specific shape or aspect ratio without altering the source file. Webstudio allows you to "crop" images visually using CSS properties, keeping your original image intact.
Method 1: Using Object-Fit
The most common approach uses the object-fit CSS property.
Steps
Add an Image component to your page
Select your image from Assets
Set a specific width and height on the image (e.g., 400px × 300px)
In the Styles panel, set
object-fittocoverUse
object-positionto control which part of the image is visible:center(default) - shows the centertop- shows the top portionbottom- shows the bottom portionleft/right- for horizontal positioningCustom values like
50% 25%for precise control
Object-Fit Values
cover
Fills container, may crop edges
contain
Fits entire image, may letterbox
fill
Stretches to fill (distorts)
none
Natural size, may overflow
Method 2: Using Overflow Hidden
This method uses a container to mask parts of the image.
Steps
Add a Box component
Set the Box's dimensions to your desired "crop" size
Set
overflow: hiddenon the BoxAdd an Image inside the Box
Make the image larger than the container
Position the image using
transform: translate()or negative margins
Method 3: Using Aspect Ratio
For responsive cropping that maintains proportions:
Add an Image component
Set width to
100%(or desired width)Set a specific
aspect-ratio(e.g.,16/9,1/1,4/3)Set
object-fit: cover
Common Use Cases
Profile pictures: Square crop with
aspect-ratio: 1/1Hero banners: Wide crop with
aspect-ratio: 21/9Thumbnails: Consistent card images with
aspect-ratio: 16/9Circular crops: Add
border-radius: 50%to any square aspect ratio
Tips
Always use
object-fit: coverwhen setting fixed dimensions on imagesUse the Design tab to preview how your "crop" looks at different viewport sizes
Consider creating multiple crops in your image editor only if you need significantly different compositions for mobile vs desktop
Related
Image – Learn about the Image component and its properties
Design tokens – Create reusable styles for consistent image sizing
Collection – Display cropped images in dynamic lists
Last updated
Was this helpful?
