Handsome documentation

Help

FAQ and troubleshooting

Answers to the questions merchants ask most, and fixes for common problems.

Setup

Will switching to Handsome change my products or orders?

No. Products, collections, customers, orders, pages, menus and blog posts belong to your store, not the theme. Only the look and the content you place in sections change.

How do I make a different layout for some products?

Create an extra template in the editor (template selector at the top → Create template), design it, then assign it to products in admin under Theme template. Do the same for collections and pages.

Why does my collection page show a placeholder banner?

The banner uses the collection's image. Upload one in Products → Collections → (collection) → Collection image. A landscape image works best; the theme crops it to each shape it needs.

How do I show star ratings?

Install a reviews app that saves ratings to Shopify's standard product rating fields (most do, for example Judge.me, Loox and Okendo). Ratings then appear on product cards and the product page automatically. Turn them on under Theme settings → Product card → Rating.

Images

What image sizes should I use?

WhereShapeSize
Slideshow and banners (desktop)Wide2400 × 1200 px or larger
Slideshow and banners (mobile)Portrait 4:51200 × 1500 px
Product photosThe same shape for every product2048 × 2048 px (square) or 1536 × 2048 px (portrait)
Collection imagesLandscape 3:22048 × 1365 px
LogoTransparent PNG or SVGAbout twice the width it displays

My product photos are cropped differently on cards and the product page

Set Theme settings → Product card → Aspect ratio to match your photos, or choose Adapt to image. For photos on white, 1:1 (square, no crop) shows the whole product.

A mega menu isn't showing

Check the block's For item matches the menu item's name exactly, including capitals, and that the item has child links in Content → Menus.

The subcollections bar reads its links from a menu. Open the Collection section, check which menu the bar uses, and edit that menu in Content → Menus.

Cart and checkout

The free shipping bar says one thing but checkout charges shipping

The bar only shows progress. Create a free shipping rate with the same minimum order in Settings → Shipping and delivery.

Customers see a Pre-order button

Products with the tag set in the Add to cart block's Pre-order tag show Pre-order instead of Add to cart. Remove the tag, or clear the setting.

Performance

How can I keep my store fast?

  • Upload images no larger than about 2500 px wide.
  • Use one video at the top of a page at most; put other videos lower down.
  • Remove apps you no longer use, and check whether they left code in your theme.
  • Keep the home page focused: every extra section adds to the page.