Note: While our most popular guides have been translated into Spanish, some guides are only available in English.
Troubleshooting cropping issues

Many images on your site will crop either horizontally, vertically, or both. This helps your images look their best within your site's layout and in different browser sizes.

This guide will help you understand the normal cropping that happens in Squarespace and learn how to minimize it as much as possible.

Tip: To crop the original image, use the Image Editor or third party software.
This guide is for version 7.0.

Understanding cropping

Every image on your site is in a container, which is an invisible box that controls how the image displays in relation to other content on the page. When an image is loaded into a container, one of two things happens, depending on the container's settings:

  • Most of the time - The image conforms to the container's dimensions, which vary based on browser width. If the image isn't the same shape as the container, the image crops to fill the container completely.
  • Sometimes - The container’s shape conforms to the dimensions of the image so the whole image displays.

In most cases, images on your site display within the containers' dimensions, and will experience some cropping. This helps images look their best while adapting to different browser sizes.


Image Blocks

Image Blocks display images at their original height and width ratio, within your site's layout restrictions.


  • Crop the image with the cropping handle. To reset the image to its original dimensions, double-click the cropping handle.
  • After cropping, use the focal point to center the image.
  • If the image is smaller than the Image Block container, check Stretch to fill the container.
  • Make the image smaller by adding Spacer Blocks on either side.


Images that are wider than they are tall usually work best. If all your banner images have the same aspect ratio, it'll be easier to anticipate how they'll crop. Set your images up for success with our best practices for responsive design.

Page banners

With a few exceptions, page banners will always crop to some degree, especially on mobile. The amount of cropping depends on the height of the banner and the width of the browser.


Site-wide banners

Images added to site-wide banner images (added within Site Styles) can repeat, display at the banner height or width, or fill the container completely.


  • Use Site Styles to set how the banner image displays.
  • Choose tweaks that look good on both mobile and desktop.
  • Use an image that's between 1500 pixels and 2500 pixels wide.

Background images

Background images can repeat, display at the browser height or width, or fill the browser screen completely.


  • Use Site Styles to choose how the banner image displays.
  • See our troubleshooting tips for help with mobile display.
  • Images that are more than 2500 pixels along their longest edge can cause issues on mobile devices.
  • When choosing a full-bleed background image, consider how visitors will access your site.

Gallery Pages

How images appear in your Gallery Page depends on your template. Visit the "Structure and style" page of your template's guide to learn how images might crop to fit your Gallery Page’s design

Gallery Blocks

How images display in a Gallery Block depends on the format: Slideshow, Grid, Carousel, or Stacked.


  • For any format, resize the whole block by adding Spacer Blocks on either side.
  • Slideshow - The gallery’s height is set by the widest image. To avoid cropping or blank space around images, use images with similar aspect ratios.
  • Grid - In the Design tab, use the aspect ratio to crop all images to the same shape, and change the number of thumbnails per row to change their size. Use the focal point to adjust how each image centers.
  • Carousel - Adjust the height with the cropping handle.
  • Stacked - Each image expands to fill the width of the page or column the block is in.

Index Pages

How images appear in an Index Page depends on your template. Visit the guide for your template's Index to learn more.

Products Pages

How your product images crop on the landing page depends on your template. To see which type of Products Page your template supports, visit this list


  • In Site Styles, use the Product Image Auto Crop tweak to choose whether the images crop to the same shape, or display at their original shapes.
  • If you're cropping, use the Product Item Size tweak to set the shape.
  • Use the focal point to adjust where the image centers.
  • If you're not cropping, use the Product Overlay Color tweak to choose the color that displays behind the image.
  • For more help, visit Styling the Classic Products Page



  • The Advanced Products Page always crops images to the same shape. This helps give your page a cohesive look and feel.
  • To set the shape for all images on your Products Page, use the Image Aspect Ratio tweak in the Products: Layout section of Site Styles.
  • Use the focal point to adjust where the image centers.



Visit these links to learn about the thumbnail styles for either of the unique Products Pages:

Cover Pages

Cover Pages will always crop to some degree, especially on mobile. The amount of cropping depends on the height of the image, the width of the browser, and the layout you've chosen.

Was this article helpful?
10 out of 75 found this helpful